Coding Tools MCP (v0.2.2): AIチャットやエージェントにコード操作の「手」を与える
Coding Tools MCP (v0.2.2):Give any AI chat or agent a pair of hands on your code (github.com)
要約
Coding Tools MCPは、AIチャットやエージェントが安全にコードベースを操作できるようにする、モデルニュートラルなランタイムです。ファイル読み取り、検索、パッチ適用、コマンド実行、Git操作などの20種類のツールを提供し、ワークスペースごとにアクセスを制限することで安全性を確保します。これにより、既存のチャットアプリケーションを強力なコーディングエージェントに変えることができます。
全文翻訳
Coding Tools MCP
English | 简体中文
Give any AI chat or agent a safe pair of hands on your codebase.
[画像: PyPI] [画像: npm] [画像: Python] [画像: compliance] [画像: release] [画像: License]
Coding Tools MCPは、Model Context Protocolを介して提供されるモデルニュートラルなコーディングランタイムです。ファイル読み取りと検索、構造化されたマルチファイルパッチ、コマンド実行、インタラクティブセッション、Gitなどの機能を提供します。単一のサーバーで、MCPクライアントであればどれでも操作できます。Claude Desktop, Claude Code, Codex, Cursor, Cline, VS Code, Windsurf, Gemini CLI、あるいは自作のエージェントは、1つのワークスペースに限定され、権限モードで保護された18個の厳選されたツールのデフォルトカタログを利用できます。
なぜ人々がこれを使うのか
- チャットアプリをコーディングエージェントに変える。 Claude Desktop — あるいは他のMCPチャットクライアント — は、あなたが既に持っているサブスクリプションで実際のリポジトリへのアクセスを得られます。追加の製品は不要です。
- 安全性は製品であり、後付けではない。 サーバーごとに1つのワークスペースルート。絶対パス、
..トラバーサル、シンボリックリンクのエスケープは拒否されます。権限モードは、ネットワークアクセス、シェル展開、インラインスクリプト、破壊的なコマンドを制限します。Linuxでは、Landlockがカーネルレベルのファイルシステム分離を追加します。 - モデルやベンダーに依存しない。 真実に注釈付けされた、モード認識型のカタログ — プロファイル切り替えや注釈ゲームは不要です。モデルやクライアントを自由に交換できます。ランタイム契約はそのままです。
- コンテキストウィンドウのために設計されている。 結果は設計により要約され、ページ分割され、キャップされます。決定論的なドッグフードワークロードで、リリースごとにシリアライズされたツール結果バイトが37%削減され、タスク完了率は変更されませんでした。
クイックスタート
既に持っているツールチェーンのいずれかで実行します(サーバーはPyPIのPython ≥ 3.11です。npmパッケージはuvまたはpipx経由で起動する薄いランチャーです)。
uvx coding-tools-mcp --stdio --workspace /path/to/repo # Python toolchain
npx coding-tools-mcp --stdio --workspace /path/to/repo # Node toolchain
Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, またはClineに接続します。JSONはどこでも同じです(Nodeを好む場合はuvxをnpxに置き換えてください)。
{
"mcpServers": {
"coding-tools": {
"command": "uvx",
"args": ["coding-tools-mcp", "--stdio", "--workspace", "/path/to/repo"]
}
}
}
その後、クライアントに「テストスイートを実行して、最初の失敗を修正してください。」と指示します。
HTTPを希望しますか? --stdioを削除すると、サーバーはhttp://127.0.0.1:8765/mcpでストリーミング可能なHTTPで通信します。どちらのプロトコルバージョンもどちらのトランスポートでも提供されます。MCP 2026-07-28は完全に、toolsのみがアドバタイズされる機能として提供され、ハンドシェイク時代 2025-11-25は2025-06-18互換性があります。どちらもセッションはありません。1行インストーラー、クライアントごとのウォークスルー、トラブルシューティングはdocs/quickstart.mdおよびdocs/mcp-client-config.mdにあります。
試してみる7つのこと
1. Claude Desktopをあなたのコーディングエージェントにする。 上記の設定だけで十分です — あなたが既に支払っているチャットウィンドウが、実際のレポジトリを読み取り、パッチを適用し、テストし、コミットレビューできるようになります。
2. どこからでも自分のマシンでコードを書く。
CODING_TOOLS_MCP_AUTH_MODE=bearer ./integrations/tunnels/tunnel.sh cloudflared /path/to/repo
ループバックバインド+認証済みHTTPSトンネル(cloudflared、ngrok、またはMicrosoft Dev Tunnel)。電話のclaude.aiをhttps://<tunnel-host>/mcpに向け、どこからでも自宅のワークステーションを操作します。ChatGPTとGrokは、コネクタ設定を通じて同じように接続します。BearerトークンとOAuth 2.1 + PKCE(RFC 7591ダイナミック登録付き)が組み込まれています。→ docs/remote-mcp.md
3. 信頼できないコードを使い捨てサンドボックス内で実行させる。
docker build -t coding-tools-mcp-sandbox:local .
docker run --rm --init -it -p 8765:8765 -v "$PWD:/workspace" coding-tools-mcp-sandbox:local
事前に設定されたツールチェーンとキャッシュを持つコンテナ化されたサーバー。怪しいPRに向けたり、後で破棄したりするのに安全です。→ docs/docker.md
4. 1回のMCP呼び出しでクラウドサンドボックスを起動する。同梱のCloudflare Workerコントロールプレーンは、MCPツールとしてstart_coding_tools_sandboxを公開します。1回の呼び出しでGitHub Actionsランナーがディスパッチされ、Dockerサンドボックスを起動し、認証済みCloudflareトンネルの後ろに公開します。一時的なコンピューティング、独自のサーバーは不要です。
5. GUIから操作する。
python -m pip install "coding-tools-mcp[desktop]"
coding-tools-mcp-desktop
ワークスペースごとのプロファイル、サーバーとトンネルの開始/停止、クリップボードヘルパー付きの認証情報設定、ライブヘルスチェック。英語と简体中文。
6. 対話型コマンドを維持する。 exec_commandは実際のPTYの下でREPLまたはデバッガを起動します。write_stdinはターンをまたいで入力を供給します。read_outputは長い出力をページングします。kill_commandはクリーンアップします。長時間実行されるプロセスは、デッドラインウォッチャードとバウンドバッファを備えたファーストクラスのオブジェクトです。
7. 独自のAIに本番グレードの操作能力を与える。 Anthropic SDKなどでAIエージェントループを構築していますか?ファイルや実行ツールを手作業で作成しないでください — このサーバーにMCPで話しかけ、安全境界全体を引き継いでください。→ docs/embedding.md
ツールカタログ
レジストリには19個の注釈付きツールが含まれています。デフォルトのsafeとtrustedモードは18個をアドバタイズします。dangerousモードはrequest_permissionsもアドバタイズしますが、これはそのツールが何かを付与できる唯一のモードです。apply_patchとapply_changesはファイル変更のプリミティブです。どちらもステージングされ、ベースラインチェックが行われ、ファイル間でアトミックであり、ロールバックをサポートします。
| グループ | ツール |
|---|---|
| ファイル & 検索 | read_file · list_dir · list_files · search_text · apply_patch · apply_changes · view_image |
| 実行 | exec_command · write_stdin · read_output · kill_command · request_permissions (dangerousのみ) |
| Git | git_status · git_diff · git_log · git_show · git_blame |
| ランタイム | server_info · check_exec_environment |
ルートのAGENTS.md/CLAUDE.mdファイルは自動的にロードされ、initializeのinstructions、またはハンドシェイクしないクライアントのserver/discoverで返されます。ツールのcontentは簡潔なエージェント向けテキストです。structuredContentは完全なマシン結果を運びます。スキーマと結果エンベロープ: docs/tools-and-schemas.md · docs/runtime-contract-v0.3.md
安全境界
| モード | 対象 | 許可される操作 |
|---|---|---|
safe (デフォルト) | 日常的なAIエージェントの作業 | ファイルツールと検証済みコマンド。ネットワーク参照コマンド、シェル展開、インラインスクリプト、破壊的なコマンドは明示的な許可が必要 |
trusted | ローカル開発 | ネットワーク、シェル展開、インラインスクリプトを許可。シークレットフィルタリングと破壊的コマンドチェックは維持 |
dangerous | 隔離されたコンテナ/VMのみ | exec_commandの権限ゲートを無効化。ワークスペースパス境界は適用される |
再帰的なリストと検索は、.git、node_modules、ビルド出力、仮想環境、キャッシュを除外します。コマンドはワークスペースにバインドされたカレントディレクトリ、クリーニングされた環境、タイムアウト、出力キャップで実行されます。Landlockを備えたLinuxホストはカーネル強制のファイルシステム分離を取得します。他のプラットフォームは明示的な警告を受け取ります。これはまだ完全なOSサンドボックスではないため、本当に信頼できない作業にはDockerイメージまたはVMを使用してください。詳細: SECURITY.md · docs/security-boundary.md · docs/permission-modes.md
テレメトリ
サーバーは、修正の優先順位付けに役立つ匿名使用テレメトリ(ツールごとの成功/レイテンシカウンターとバージョン/プラットフォームのディメンション — パス、引数、コマンド、ファイルの内容は含まない)を送信します。CODING_TOOLS_MCP_TELEMETRY=offまたはDO_NOT_TRACK=1で無効にできます。CIでは自動的にオフになります。CODING_TOOLS_MCP_TELEMETRY=debugは、イベントを送信する代わりにすべてのイベントをstderrに出力します。イベントリストと保証はdocs/telemetry.mdにあります。
エビデンス、ドッグフード、SWE-bench
すべてのリリースは、コンプライアンススイート、実際のワークロードベンチマーク、SWE-benchハーネスがPyPIとnpmに公開されるのと同じコミットから実行されるタグトリガーパイプラインを通じて出荷されます — どちらも信頼できる公開を通じて、npmはプロビナンス付きです。ドッグフード効率メトリクスは再現可能(make dogfood-smoke)で、reports/の下にチェックインされています。このリポジトリはモデル生成されたSWE-benchリーダーボードの結果を主張しません — 何が測定され、何が測定されていないかについてはdocs/swe-bench.mdを参照してください。詳細: COMPLIANCE.md · BENCHMARK.md · docs/dogfood.md
ドキュメント
| ドキュメントマップ | トピック別ドキュメントを参照 |
| 開始方法 | クイックスタート · クライアント設定 · トラブルシューティング |
| リモート & サンドボックス | リモートMCP · Dockerサンドボックス · クラウドサンドボックスワーカー |
| ツール & 契約 | ツールとスキーマ · ランタイム契約 · 0.3への移行 · 権限モード |
| 実行 | 実行レシピ · 実行トラブルシューティング |
| 統合 | 埋め込み · npmランチャー |
| セキュリティ & 品質 | セキュリティポリシー · セキュリティ境界 · CIとテスト · 制限事項 · 競合分析 |
開発
python -m pip install -e "'.[dev]'"
make ci # lint, typecheck, tests, protocol/integration suites, gates
完全なゲートマトリックスはdocs/ci-and-tests.mdにあります。
ライセンス
このプロジェクトはApache License 2.0の下でライセンスされています。
このプロジェクトからのコード、ドキュメント、実質的な実装詳細、または派生物を使用する場合、著作権表示、ライセンス表示、およびNOTICEファイルを保持し、元のプロジェクトを明確に帰属させてください。
プロジェクト: Coding Tools MCP
著者: Coding Tools MCP Contributors
ソース: https://github.com/xyTom/coding-tools-mcp
引用メタデータはCITATION.cffで利用可能です。