claude-code-mcp プロジェクト
アップデート
現在、この MCP サーバーは npx によるローカル インストールなしで動作します。
Related MCP server: Fused MCP Agents
概要
claude-code-mcp プロジェクトは、Claude Code 用の MCP サーバーです。
ローカルにインストールされたClaude Codeコマンドを呼び出し、 explain_code 、 review_code 、 fix_code 、 edit_code 、 test_code 、 simulate_command 、 your_own_queryといったツールを提供します。サーバはNode.jsとMCP SDKを用いて実装されており、クライアントからのJSON形式のリクエストをstdio経由で受信します。内部的にはBase64エンコードを採用しており、自然言語テキスト中の特殊文字（改行や引用符など）をスムーズに処理することで、安定性と柔軟性を向上させています。主な役割は、リクエストの受信、入力のエンコード、コマンドの生成と実行、実行結果のJSON形式での返却です。本プロジェクトはClaude CodeのCLI環境（Ubuntu/WSL2など）で動作を確認しています。
💡 LLM の能力が低い MCP ホストでも、Claude のパワーを制御・活用できます💪！ claude-code-mcp を使えば、Claude Desktop から Claude Code を呼び出すこともできます!! 😇😜😎 (未確認)
機能
サーバーの主な役割は次のとおりです。
**リクエストの受信:**クライアントから JSON 形式のツール リクエスト (例:
code、context、focus_areasなど) を受信します。**入力処理:**受信した自然言語テキストを内部的に Base64 でエンコードします。
**ツールの選択とコマンド生成:**リクエスト内のツール名に基づいて、固定テンプレートまたは自由形式 (
your_own_query) を使用してクエリのコマンド文字列を組み立てます。コマンド実行: Node.js の
child_process.spawnを使用して、組み立てられたコマンドを実行し、標準出力から結果を取得します。**結果の戻り:**実行結果を JSON 形式でクライアントに返します。
はじめる
前提条件
Node.js (v18 以上を推奨、v22.14.0 でテスト済み)
npm（またはyarn）
Claude Code コマンドがインストールされ、認証が完了しました。https ://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview
インストールと使用方法
claude-code-mcpを使用するにはいくつかの方法があります。
1. npx を使用する（手軽に使う場合におすすめ）
npxを使用すると、インストールせずにサーバーを直接実行できます。
2. グローバルインストール
パッケージをグローバルにインストールします。
次に、コマンドとして実行します。
3. ローカルインストール（開発用）
リポジトリをクローンし、依存関係をインストールします。
その後、ビルドしたスクリプトを直接実行できます。
構成
環境変数:
インストール方法に関わらず、環境変数を設定する必要があります。以下のいずれかのファイルを作成してください。
MCPホスト設定の使用（ MCPホストの設定内で環境変数を直接設定します（下記の「MCPホスト設定」を参照）
npxを使用する場合、これが最も簡単な方法です。.envnpx @kunihiros/claude-code-mcpコマンドを実行するディレクトリに.envファイルを作成します。**グローバル設定ファイルの使用:**ホームディレクトリ (
~/.claude-code-mcp.env) に.claude-code-mcp.envファイルを作成します。
ファイル ( .envまたは~/.claude-code-mcp.env ) を使用する場合は、 CLAUDE_BINパスを調整して次のコンテンツを追加します。
MCP ホスト構成 (
MCPホストアプリケーションの設定（例：Claude Desktopの設定）に以下の設定を追加してください。この方法により、環境変数を直接設定できます。
(ホスト アプリケーションの再起動が必要になる場合があります。)
代替 MCP ホスト構成 (グローバル インストール / ローカル開発):
パッケージをグローバルにインストールした場合、またはクローンしたリポジトリからローカルに実行していて、 claude-code-mcpコマンドがシステムの PATH にある場合は、次を使用できます。
この場合、上記のように.envファイルまたはグローバル~/.claude-code-mcp.envファイルを使用して環境変数を構成する必要があります。
環境変数の詳細
このサーバーは、次の環境変数を使用します (MCP ホストenv設定、 .env 、または~/.claude-code-mcp.envを介して設定されます)。
CLAUDE_BIN: Claude CLI 実行可能ファイルへのパスを指定します。 **(必須)**例:/home/linuxbrew/.linuxbrew/bin/claudeまたはC:\Users\YourUser\AppData\Local\bin\claude.exeLOG_LEVEL: ログレベルを指定します。(オプション、デフォルトはinfo)。指定できる値:debug、info、warn、error。
利用可能なツール
claude-code-mcpサーバーは次のツールを提供します。
explain_code: 指定されたコードの詳細な説明を提供します。review_code: 指定されたコードをレビューします。fix_code: 指定されたコード内のバグや問題を修正します。edit_code: 指示に基づいて指定されたコードを編集します。test_code: 指定されたコードのテストを生成します。simulate_command: 指定されたコマンドの実行をシミュレートします。your_own_query: コンテキスト付きのカスタムクエリを送信します。
注記
ログファイル (
claude-code-mcp.log) の場所:まずプロジェクト ルートに作成を試みます。
ユーザーのホームディレクトリ (
~/.claude-code-mcp.log) にフォールバックします。最終的に
/tmp/claude-code-mcp.logにフォールバックします。
ログのローテーションはまだ実装されていません (ログ ファイルのサイズに注意してください)。
主に Ubuntu/WSL2 上の Claude CLI でテストされました。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については下記を参照してください。
免責事項
このソフトウェアは教育および研究目的のみに提供されています。このプロジェクトはAnthropicと公式に提携しておらず、Anthropicの承認も受けていません。ClaudeはAnthropicの商標です。
このプロジェクトはClaude CLIを依存関係として利用していますが、独立したコミュニティ主導の取り組みです。ユーザーは、このプロジェクトを使用する際に、Anthropicの利用規約を遵守する必要があります。
このプロジェクトの管理者は、ソフトウェアの誤用やサードパーティの API またはサービスの利用規約違反について一切責任を負いません。