claude-code-mcp

claude-code-mcp プロジェクト

アップデート

現在、この MCP サーバーは npx によるローカル インストールなしで動作します。

概要

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. ローカルインストール（開発用）

リポジトリをクローンし、依存関係をインストールします。

その後、ビルドしたスクリプトを直接実行できます。

構成

環境変数:

インストール方法に関わらず、環境変数を設定する必要があります。以下のいずれかのファイルを作成してください。

1. MCPホスト設定の使用（ npxの場合に推奨）： MCPホストの設定内で環境変数を直接設定します（下記の「MCPホスト設定」を参照） npxを使用する場合、これが最も簡単な方法です。
2. .envファイルの使用: npx @kunihiros/claude-code-mcpコマンドを実行するディレクトリに.envファイルを作成します。
3. **グローバル設定ファイルの使用:**ホームディレクトリ ( ~/.claude-code-mcp.env ) に.claude-code-mcp.envファイルを作成します。

ファイル ( .envまたは~/.claude-code-mcp.env ) を使用する場合は、 CLAUDE_BINパスを調整して次のコンテンツを追加します。

MCP ホスト構成 ( npxに推奨):

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.exe
• LOG_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 またはサービスの利用規約違反について一切責任を負いません。