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)。