claude-code-mcp Project

claude-code-mcp プロジェクト

⚠️ メンテナンス終了（2026-08-25）

このプロジェクトはメンテナンスを終了しました。セキュリティ修正を含め、今後のアップデートは行われません。 リポジトリはアーカイブされ、npm パッケージは非推奨としてマークされています。 既存のインストールは引き続き動作しますが、ご自身の責任でご利用ください。この日付以降に報告された依存関係の脆弱性には対応しません。

同等の機能が必要な場合は、リポジトリをフォークするか、現在もメンテナンスされている代替手段をお探しください。

---

[0.1.9] - 2026-03-06

セキュリティアップデート

• pnpm の overrides を追加し、推移的依存関係を修正済みバージョンに固定しました。
  • hono ^4.12.4（serveStatic のパストラバーサル、SSE の CRLF インジェクション、Cookie 属性のインジェクション、basicAuth/bearerAuth のタイミングに関する問題を修正）
  • @hono/node-server >=1.19.10（エンコードされたスラッシュを介した認可バイパスを修正）
  • ajv >=8.18.0（$data オプションによる ReDoS を修正）
  • qs >=6.14.2（arrayLimit のバイパスによる DoS を修正）

[0.1.8] - 2026-02-05

セキュリティアップデート

• @modelcontextprotocol/sdk のバージョンを更新しました。
• ピア依存関係の要件を満たすため、zod 依存関係を追加しました。
• 更新された依存関係との互換性のため、TypeScript のバージョンを引き上げました。

概要

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 を使用して実装されており、クライアントから stdio 経由で JSON 形式のリクエストを受け取ります。内部では、自然言語テキスト内の特殊文字（改行、引用符など）をスムーズに処理するために 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

設定

環境変数：

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

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 のパスを調整して、以下の内容を追加してください：

# .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 やサービスの利用規約への違反について、一切の責任を負いません。