Claude Code MCP

🚀 claude - code - mcp 項目文檔

claude-code-mcp 是一個強大的代碼工具，它提供了代碼解釋、審查、修復等多種功能。通過調用 Anthropic 的 Claude CLI 實現這些功能，並且完全開源，由社區驅動，無商業用途，能廣泛應用於教育、研究等場景。

🚀 快速開始

先決條件

1. 確保系統已安裝 Node.js（推薦版本：LTS）。
2. 配置環境變量 CLAUDE_BIN 指向 Claude CLI 的可執行文件路徑。
3. 根據需求，配置日誌記錄級別。

使用方法

方式一：通過 npm 包運行

npx claude-code-mcp

方式二：本地開發使用

克隆倉庫後安裝依賴並啟動：

npm install
npm start

✨ 主要特性

功能模塊

• explain_code：提供對給定代碼的詳細解釋。
• review_code：審查並評估給定的代碼質量。
• fix_code：修復代碼中的錯誤或潛在問題。
• edit_code：根據指令編輯代碼內容。
• test_code：自動生成代碼的測試用例。
• simulate_command：模擬執行給定命令的行為。
• your_own_query：支持自定義查詢，結合上下文信息進行分析。

實現方式

該工具基於 Node.js 開發，使用標準輸入輸出與 Claude CLI 進行交互。用戶可以通過配置環境變量指定 Claude CLI 的路徑，並選擇日誌記錄的級別（默認為 info）。

適用場景

• 教育和研究用途。
• 提供代碼審查、測試生成等輔助功能。
• 支持自定義查詢，滿足個性化需求。

📦 安裝指南

先決條件

1. 確保系統已安裝 Node.js（推薦版本：LTS）。
2. 配置環境變量 CLAUDE_BIN 指向 Claude CLI 的可執行文件路徑。
3. 根據需求，配置日誌記錄級別。

使用方法

方式一：通過 npm 包運行

npx claude-code-mcp

方式二：本地開發使用

克隆倉庫後安裝依賴並啟動：

npm install
npm start

📚 詳細文檔

配置說明

環境變量

• CLAUDE_BIN：指定 Claude CLI 的路徑，必填項。
  • 示例：/home/user/.local/bin/claude（Linux）或 C:\Users\User\AppData\Local\bin\claude.exe（Windows）。
• LOG_LEVEL：設置日誌記錄級別，默認為 info。
  • 可選值：debug, info, warn, error。

配置文件

支持通過以下方式配置：

1. 在項目根目錄創建 .env 文件，添加環境變量。
2. 創建全局配置文件 ~/.claude-code-mcp.env。
3. 在運行時通過命令行參數指定。

工具列表

提供的工具

• explain_code：對代碼進行詳細解釋。
• review_code：審查代碼並提供建議。
• fix_code：修復代碼中的錯誤或問題。
• edit_code：根據指令編輯代碼。
• test_code：自動生成測試用例。
• simulate_command：模擬命令執行過程。
• your_own_query：支持自定義查詢，結合上下文信息。

示例

# 使用 explain_code 工具
claude-code-mcp --tool explain_code --code "function hello() { console.log('Hello, World!'); }"

🔧 技術細節

該工具基於 Node.js 開發，使用標準輸入輸出與 Claude CLI 進行交互。用戶可以通過配置環境變量指定 Claude CLI 的路徑，並選擇日誌記錄的級別（默認為 info）。

⚠️ 注意事項

• 日誌文件：默認情況下，日誌文件將創建在項目根目錄下。如果無法創建，則嘗試寫入用戶主目錄或 /tmp 目錄。
• 日誌輪轉：暫未實現日誌自動切割功能，請手動管理日誌文件大小。
• 主要測試平臺：該工具已在 Linux 系統上進行了充分測試，Windows 平臺可能需要額外配置。

📄 許可證

本項目遵循 MIT 許可證，允許用戶自由使用、修改和分發代碼，但需在保留版權聲明的前提下進行。

⚠️ 免責聲明

• 該項目僅為教育和研究用途而開發。
• 不對因不當使用或其他任何方式導致的後果負責。
• 請遵守 Anthropic 的服務條款和條件。