Just MCP

🚀 just-mcp

👋 LLMがJustを使えるようにする方法

本番環境で使用できるMCPサーバーです。Justコマンドランナーとシームレスに統合され、AIアシスタントが標準化されたMCPプロトコルを通じてJustfileのレシピを探索、実行、内省できるようになります。

🚀 クイックスタート

インストール

好みのインストール方法を選んでください。

npm (JavaScript/TypeScript)

# グローバルにインストール
npm install -g just-mcp

# またはnpxで使用（インストール不要）
npx just-mcp --stdio

pip (Python)

# pipでインストール
pip install just-mcp

# またはuvxで使用（推奨）
uvx just-mcp --stdio

Cargo (Rust)

# crates.ioからインストール
cargo install just-mcp

# またはソースからビルド
git clone https://github.com/promptexecution/just-mcp
cd just-mcp
cargo build --release

pkgx (pkgxdev)

pkgx just-mcp --stdio

pkgxはGitHubリリースで公開されているプラットフォーム固有のtarボール (just-mcp-*-*.tar.gz) をダウンロードし、実行可能ファイルを ${PKGX_DIR:-$HOME/.pkgx}/bin に抽出し、渡された引数でCLIを実行します。just-mcpを長期的に使用する場合は、そのバイナリディレクトリをシェルのPATHに追加してください。パッケージマニフェストは にあり、pkgxdev/pantryのエントリを反映しています。

Dockerを使用する

# GitHub Container Registryから最新のイメージを取得
docker pull ghcr.io/promptexecution/just-mcp:latest

# Dockerで実行
docker run --rm -v $(pwd):/workspace ghcr.io/promptexecution/just-mcp:latest --stdio

# ローカルでビルド
docker build -t just-mcp:local .
docker run --rm -v $(pwd):/workspace just-mcp:local --stdio

利用可能なDockerイメージタグ:

• latest - 最新の安定リリース
• X.Y.Z - 特定のバージョン (例: 0.1.0)
• X.Y - 最新のパッチバージョン (例: 0.1)
• X - 最新のマイナーバージョン (例: 0)

Claude Desktopとの統合

npm/npxを使用する場合

Claude DesktopのMCP設定に追加します。

バイナリを使用する場合

{
  "mcpServers": {
    "just-mcp": {
      "command": "npx",
      "args": ["-y", "just-mcp", "--stdio"]
    }
  }
}

pip/uvxを使用する場合

{
  "mcpServers": {
    "just-mcp": {
      "command": "uvx",
      "args": ["just-mcp", "--stdio"]
    }
  }
}

cargoまたは手動インストールを使用する場合

{
  "mcpServers": {
    "just-mcp": {
      "command": "/path/to/just-mcp",
      "args": ["--stdio"]
    }
  }
}

Dockerを使用する場合

{
  "mcpServers": {
    "just-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "${workspaceFolder}:/workspace",
        "ghcr.io/promptexecution/just-mcp:latest",
        "--stdio"
      ]
    }
  }
}

使用例

# MCPサーバーとして実行
just-mcp --stdio

# 特定のディレクトリで実行
just-mcp --directory /path/to/project --stdio

# Dockerを使用する場合
docker run --rm -v $(pwd):/workspace ghcr.io/promptexecution/just-mcp:latest --stdio

✨ 主な機能

コンテキスト保存抽象化

LLMがbashではなくJustを使用する利点は、Justコマンドを（MCPを介して）実行することで、bashファイル、Pythonスクリプト、または他のビルドアーティファクトを開いたり読んだりするコンテキストを浪費する必要がないコンテキスト保存抽象化が提供されることです。MCPを介したLLMは単にコマンド、パラメータ、ヒントを取得します - これらは「あなたが使用できるコマンド」としてメモリに保存されます。

Justfileの学習曲線を排除

LLMがjust -lを実行してコマンドリストを取得し、必然的にjustfileを読み始め、次にjustfile構文（Makefileのように）を書こうとし、justfileを破損させ、悪い体験を作り出すのを見ることはもうありません。Justの進化する構文は、今日の最先端のモデルではまだ十分なコーパスがないため、トレーニングデータセットにjustfileを持つより多くの人気のあるリポジトリが必要です。

生のbashアクセスよりも安全

Just-mcpは基本的にbashよりも安全です。HackerNewsを読めば、少なくとも毎日1回、LLMが忘れ始め、幻覚を起こし、最終的に崩壊してファイルを削除したり、望ましくないことをしたりするオペレーターの話があります。コンテキスト消費を注意深く監視せずにLLMに無監督、無制限のbashアクセスを与えることは、災害の原因になります。

Justfileを使用することでそれを修正します。 LLMが独自のjustfileを変更したとしても、次のコンテキストはjustfileによってメモ化されます（できれば冪等性のあるgitリポジトリで）。この抽象化により、幻覚や現在の作業ディレクトリの追跡による注意散漫が原因でコマンドラインの複雑さからLLMを守り、崖から落ちることを防ぎます。

強力なエージェント実行ツール

Just-mcpはエージェント実行を行う人に最適です。

• 超低オーバーヘッド - 他のツールよりも優れている可能性があります
• 人間にやさしい - justfileは人間にとって簡単で、LLMにとってもオーバーヘッドが少ない
• 簡単で即座に使える - 完全なPython FastAPIサーバーを好む人もいますが、just-mcpはとても簡単です
• 小型モデルに適している - 8k - 32kのコンテキスト制限を持つ自前のGPU/CPUオープンソースモデルでもうまく動作します

組み込みの安全パターン

Justには次のような便利なパターンがあります。

• 透過的なロギング - エージェントを煩わせることなく
• 二次モデル検査 - 小型モデルを使用して、実行前に「これは有害ですか？」という質問をするコマンドをスキャンする
• コマンド検証のためのPythonデコレータのようなパターン
• gitリポジトリによる冪等性のある実行

🧪 テスト

包括的なテストスイート

# すべてのテストを実行（33個のテスト）
cargo test

# 特定のテストスイートを実行
cargo test --test basic_mcp_test      # プロトコル準拠テスト
cargo test --test mcp_integration_working  # SDK統合テスト

テストアーキテクチャ

• basic_mcp_test.rs - 生のJSON-RPCを使用した直接的なプロトコル準拠テスト
• mcp_integration_working.rs - rmcpクライアントを使用した型安全なSDK統合テスト
• 単体テスト - パーサー、エグゼキューター、バリデーター、および環境モジュールをカバーする25個以上のテスト

📚 ドキュメント

プロジェクト構造

just-mcp/
├── src/main.rs              # CLIバイナリ
├── just-mcp-lib/           # コアライブラリ
│   ├── parser.rs           # Justfileのパース
│   ├── executor.rs         # レシピの実行
│   ├── validator.rs        # 検証ロジック
│   ├── environment.rs      # 環境管理
│   └── mcp_server.rs       # MCPプロトコルの実装
├── tests/                  # 統合テスト
└── justfile               # デモレシピ

技術スタック

• Rust 1.82+ 非同期/待機サポート付き
• rmcp 0.3.0 - Rust用の公式MCP SDK
• serde/serde_json - JSONシリアライゼーション
• snafu - 構造化エラーハンドリング
• tokio - 非同期ランタイム

🔧 技術詳細

開発ロードマップ

次の優先タスク (残り33%)

1. LSPスタイルの補完システム - レシピとパラメータのインテリジェントな自動補完
2. 拡張診断 - 高度な構文エラー報告と提案
3. 仮想ファイルシステム - 標準入力、リモートソース、およびメモリ内バッファのサポート
4. リリース準備 - ドキュメント、CI/CD、およびクレートの公開

将来的な機能強化

• カスタムレシピタイプのプラグインシステム
• 他のビルドツールとの統合
• 大規模なjustfileのパフォーマンス最適化
• 高度な依存関係の可視化

使用パターン

レシピの実行

// 利用可能なレシピをリストする
await client.callTool("list_recipes", {});

// パラメータ付きでレシピを実行する
await client.callTool("run_recipe", {
  "recipe_name": "build",
  "args": "[\"--release\"]"
});

// レシピの情報を取得する
await client.callTool("get_recipe_info", {
  "recipe_name": "test"
});

検証

// justfileを検証する
await client.callTool("validate_justfile", {
  "justfile_path": "./custom.justfile"  
});

🤝 コントリビュート

このプロジェクトは に従っています。

• TDDアプローチ - まずテストを作成し、次に実装を行う
• 機能ブランチ - メインブランチで直接作業しない
• 構造化エラー - snafuを使用したエラー管理
• Gitワークフロー - 説明的なメッセージを持つクリーンなコミット

開発コマンド

just build    # プロジェクトをビルドする
just test     # テストを実行する
just server   # MCPサーバーを起動する
just clean    # ビルドアーティファクトをクリーンアップする

📄 ライセンス

このプロジェクトは LICENSE の下でライセンスされています。

🔗 関連プロジェクト

• Just - 統合されるコマンドランナー
• Model Context Protocol - プロトコル仕様
• rmcp - 公式Rust MCP SDK

just-mcpの仲間たち

• just-vscode - LSP統合による強化されたJustの作成用のVSCode拡張機能
• just-awesome-agents - Justを使用したエージェント実行のパターンとツールのコレクション