Consulting Agents MCP

🚀 咨询代理服务说明文档

本咨询代理服务文档详细介绍了服务的安装、配置、使用等方面的信息，帮助用户顺利使用该服务解决各类咨询问题。

🚀 快速开始

要使用咨询代理服务，首先需要进行安装和配置。按照以下步骤操作，即可快速启动服务。

📦 安装指南

环境要求

• 操作系统：支持 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。