咨询代理服务说明文档

安装指南

环境要求

• 操作系统：支持 Unix 的系统（如 Linux 或 macOS）
• Python 版本：3.6 及以上版本
• 依赖管理工具：pip

安装步骤

1. 克隆项目仓库：

   git clone https://github.com/username/repo.git
   cd repo
   

2. 安装依赖项：

   pip install -r requirements.txt
   

配置指南

环境变量配置

在项目的根目录下创建一个 .env 文件，并添加以下内容：

MCP_TRANSPORT=stdio  # 可选值：stdio, http, sse，默认为 stdio
HOST=127.0.0.1        # 默认值：127.0.0.1
PORT=5000            # 默认值：5000

使用指南

启动服务

DEBUG=true ./start_mcp_server.sh

通过 HTTP API 调用模型

当使用 HTTP 运输协议时，可以通过以下接口调用不同模型：

• Darren/Sonny：用于基本咨询问题。
• Sergey：用于搜索相关技术问题。
• Gemma：用于基于 GitHub 仓库的代码分析。

示例请求

{
  "agent": "Darren",
  "consultation_context": "我遇到了一个代码错误，其中...",
  "source_code": "def example():\n    return 'hello'"
}

故障排除

常见问题解答

1. MCP 服务器未找到：请检查 claude mcp add 命令中的绝对路径是否正确。
2. API 认证失败：确认 .env 文件中的 API 密钥设置无误。
3. 连接问题：确保 MCP 服务器已启动后再运行 Claude Code。

调试日志

查看 MCP 服务器终端的详细日志，以获取更多调试信息。

更新指南

1. 拉取最新代码：

   git pull origin master
   

2. 重启 MCP 服务器：

   ./start_mcp_server.sh
   

开发指南

运行开发版本

DEBUG=true ./start_mcp_server.sh

测试接口

使用 curl 命令测试 HTTP 接口：

# 测试 Darren 模型
curl -X POST http://localhost:5000/consult \
  -H "Content-Type: application/json" \
  -d '{"agent":"Darren","consultation_context":"测试消息"}'

项目结构

• mcp_consul_server.py：MCP 服务器核心实现
• start_mcp_server.sh：启动脚本
• requirements.txt：依赖管理文件

许可证

请参考项目的 LICENSE 文件。

联系方式

如有任何问题，请联系 support@consulting-agents.com。