Claude Code

🚀 claude - code - mcp 項目文檔

claude-code-mcp 是一個用於 Claude Code 交互的 MCP 服務器項目。它支持代碼解釋、審查、修復、編輯、測試、命令模擬以及自定義查詢等功能，為開發者提供了便捷的代碼處理解決方案。

🚀 快速開始

現在可以通過 npx 本地運行服務器，無需額外安裝。

✨ 主要特性

• 接收請求：處理來自客戶端的 JSON 格式請求。
• 處理輸入：對輸入內容進行 Base64 解碼和 UTF - 8 編碼處理。
• 選擇工具：根據需求選擇合適的工具（如 explain_code、review_code 等）。
• 生成命令：基於上下文生成相應的 Claude CLI 命令。
• 執行命令：在服務器端執行生成的命令，並捕獲輸出結果。
• 返回結果：將處理後的結果以 JSON 格式回傳給客戶端。

📦 安裝指南

方法一：使用 npx

直接通過 npx 運行：

npx claude-code-mcp

方法二：全局安裝

使用 npm 安裝全局包：

npm install -g claude-code-mcp

方法三：本地開發

克隆倉庫後運行：

git clone https://github.com/yourusername/claude-code-mcp.git
cd claude-code-mcp
npm start

📚 詳細文檔

配置說明

通過環境變量進行配置，支持以下變量：

工具列表

1. explain_code

對給定代碼提供詳細解釋。

2. review_code

審查並評估給定代碼的質量。

3. fix_code

修復代碼中的錯誤或問題。

4. edit_code

根據指令修改代碼內容。

5. test_code

為給定代碼生成測試用例。

6. simulate_command

模擬命令的執行過程。

7. your_own_query

發送自定義查詢請求，支持上下文信息。

🔧 技術細節

注意事項

⚠️ 重要提示

• 日誌文件默認在項目根目錄創建，若失敗則依次嘗試用戶主目錄和 /tmp 目錄。
• 日誌輪轉功能尚未實現，請注意日誌文件大小問題。
• 主要測試環境適用於 Ubuntu/WSL2 系統。

免責聲明

⚠️ 重要提示

本軟件僅用於教育和研究目的。該項目與 Anthropic 無關，未經授權禁止任何商業用途。Claude 是 Anthropic 的商標。此項目使用 Claude CLI 作為依賴項，但是一個獨立的社區驅動項目。請確保遵守 Anthropic 的服務條款。

📄 許可證

本項目採用 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.