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を使用すると、インストールせずにサーバーを直接実行できます。

npx @kunihiros/claude-code-mcp

2. グローバルインストール

パッケージをグローバルにインストールします。

npm install -g claude-code-mcp

次に、コマンドとして実行します。

claude-code-mcp

3. ローカルインストール（開発用）

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

git clone https://github.com/KunihiroS/claude-code-mcp.git
cd claude-code-mcp/claude-code-server
npm install
npm run build

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

node build/index.js

構成

環境変数:

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

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

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

# .env or ~/.claude-code-mcp.env
CLAUDE_BIN=/path/to/your/claude/executable  # REQUIRED: Set the full path to your Claude CLI
LOG_LEVEL=info                             # Optional: Set log level (e.g., debug, info, warn, error)

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

MCPホストアプリケーションの設定（例：Claude Desktopの設定）に以下の設定を追加してください。この方法により、環境変数を直接設定できます。

    "claude-code-server": {
      "command": "npx",
      "args": [
        "-y",
        "@kunihiros/claude-code-mcp"
      ],
      "env": {
        "CLAUDE_BIN": "/path/to/your/claude/executable", // REQUIRED: Set the absolute path
        "LOG_LEVEL": "info"                             // Optional: Set log level
      },
      "disabled": false
    }

(ホストアプリケーションの再起動が必要になる場合があります。)

代替 MCP ホスト構成 (グローバルインストール / ローカル開発):

パッケージをグローバルにインストールした場合、またはクローンしたリポジトリからローカルに実行していて、 claude-code-mcpコマンドがシステムの PATH にある場合は、次を使用できます。

    "claude-code-server": {
      "command": "claude-code-mcp",
      "disabled": false
    }

この場合、上記のように.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 ライセンスに基づいてライセンスされています - 詳細については下記を参照してください。

MIT License

Copyright (c) 2024 KunihiroS

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

免責事項

このソフトウェアは教育および研究目的のみに提供されています。このプロジェクトはAnthropicと公式に提携しておらず、Anthropicの承認も受けていません。ClaudeはAnthropicの商標です。

このプロジェクトはClaude CLIを依存関係として利用していますが、独立したコミュニティ主導の取り組みです。ユーザーは、このプロジェクトを使用する際に、Anthropicの利用規約を遵守する必要があります。

このプロジェクトの管理者は、ソフトウェアの誤用やサードパーティの API またはサービスの利用規約違反について一切責任を負いません。

claude-code-mcp