Codealive

🚀 CodeAlive MCP 服務器配置指南

CodeAlive MCP 服務器是一款用於與各類 AI 客戶端集成的中間件工具。本指南將詳細指導您如何配置 MCP 服務器，以支持不同的 AI 客戶端，如 Claude Desktop、Cursor 以及 VS Code 中的 Continue/Copilot 插件。

🚀 快速開始

激活虛擬環境

在運行 MCP 服務器之前，請先激活 Python 虛擬環境：

source venv/bin/activate  # 適用於 macOS/Linux 用戶
# 或者對於 Windows 用戶，使用 PowerShell 進入項目目錄並運行：
# .\venv\Scripts\activate

啟動 MCP 服務器

在虛擬環境中，設置 CODEALIVE_API_KEY 環境變量（請將其替換為您的實際 API 密鑰），然後啟動 MCP 服務器：

export CODEALIVE_API_KEY="your_api_key_here"
python src/codealive_mcp_server.py --debug

✨ 客戶端配置

Claude Desktop 配置

1. 打開 Claude Desktop 的設置界面。
2. 進入“MCP”或“擴展”部分，添加一個新的 MCP 服務器：
   • 名稱：codealive
   • 類型：CodeAliveMcpProvider
3. 填寫以下配置參數：

   {
     "command": "path/to/venv/bin/python",
     "args": [
       "src/codealive_mcp_server.py",
       "--debug"
     ],
     "env": {
       "CODEALIVE_API_KEY": "your_api_key_here"
     }
   }
   

Cursor 配置

1. 打開 Cursor 的設置。
2. 導航到“MCP”部分，添加新的服務器配置：
   • 名稱：codealive
   • 路徑：指向您的 Python 可執行文件（例如 /path/to/venv/bin/python）。

VS Code 中的 Continue/Copilot 插件

1. 打開 VS Code 的設置。
2. 搜索並進入“Continue”或“GitHub Copilot”的配置界面。
3. 添加 MCP 服務器配置：

   {
     "mcp.servers": [
       {
         "name": "codealive",
         "type": "CodeAliveMcpProvider",
         "command": "path/to/venv/bin/python",
         "args": ["src/codealive_mcp_server.py", "--debug"],
         "env": {
           "CODEALIVE_API_KEY": "your_api_key_here"
         }
       }
     ]
   }
   

🔧 故障排除

啟用調試日誌

在客戶端配置中添加 --debug 標誌以啟用詳細日誌記錄：

{
  "args": [
    "src/codealive_mcp_server.py",
    "--debug"
  ]
}

檢查 MCP 服務器輸出

嘗試直接運行 MCP 服務器命令，確保沒有錯誤信息，並注意以下內容：

• 確保 CODEALIVE_API_KEY 正確無誤。
• 查看是否存在連接問題或其他異常情況。

客戶端日誌檢查

根據您使用的客戶端查閱相關日誌文件：

• Claude Desktop：
  • macOS：/Users/your_username/Library/Logs/Claude/mcp.log
  • Windows：C:\Users\your_username\AppData\Local\Claude\logs\mcp.log
• Cursor：查看 VS Code 的輸出面板或控制檯。
• VS Code：檢查“開發者工具”中的日誌。

驗證環境變量

確保在客戶端配置中正確設置了 CODEALIVE_API_KEY 環境變量，並且沒有拼寫錯誤或其他格式問題。

📄 許可證

CodeAlive MCP 服務器遵循 MIT 許可證。請查閱項目倉庫以獲取完整的許可條款和條件。

如果您在配置過程中遇到任何問題，請參考 官方文檔 或聯繫支持團隊 (support@codealive.dev)。