星战科技xingzhan.cloud
返回市场
咨询代理-mcp

咨询代理-mcp

作者：MatthewPDingle14 星标更新：2025-04-03
安装使用来源：spider==github.com

项目介绍

ConsultingAgents MCP Server

一个基于模型上下文协议（MCP）的服务器，允许Claude Code与额外的AI代理进行代码和问题分析咨询。此服务器提供了访问Darren（OpenAI）、Sonny（Anthropic）、Sergey（OpenAI带网络搜索）和Gemma（Google Gemini带仓库分析）作为专家顾问的功能，从而实现多模型视角下的编码问题分析。

功能

  • Darren：由具有高推理能力的o3-mini模型驱动的OpenAI专家编程顾问
  • Sonny：由具有增强思考能力的Claude 3.7 Sonnet模型驱动的Anthropic专家编程顾问（注意：由于Claude Code现在具有原生扩展思考模式，这一功能有些冗余）
  • Sergey：由GPT-4o驱动的OpenAI网络搜索专家，用于查找相关文档和示例（注意：由于Claude Code现在具有原生网络搜索能力，这一功能有些冗余）
  • Gemma：由具有1M令牌上下文窗口的gemini-2.5-pro-exp-03-25模型驱动的Google Gemini专家，用于全面的仓库分析
  • MCP集成：通过MCP协议无缝集成到Claude Code中
  • 多种传输选项：支持stdio（用于直接集成到Claude Code）和HTTP/SSE传输

预备条件

  • Python 3.8+
  • OpenAI API密钥
  • Anthropic API密钥
  • Google API密钥
  • Claude Code CLI（用于集成）

快速开始

  1. 克隆仓库：

    git clone https://github.com/yourusername/consulting-agents-mcp.git
cd consulting-agents-mcp

  2. 创建并激活虚拟环境：

    python -m venv mcp_venv
source mcp_venv/bin/activate  # 在Windows上使用：mcp_venv\Scripts\activate

  3. 安装依赖项：

    pip install -r requirements.txt

  4. 设置API密钥： 在项目根目录下创建一个.env文件：

    OPENAI_API_KEY=your_openai_api_key_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here
GOOGLE_API_KEY=your_google_api_key_here

  5. 启动服务器：

    chmod +x start_mcp_server.sh
./start_mcp_server.sh

与Claude Code的集成

  1. 注册MCP服务器 到Claude Code：

    claude mcp add ConsultingAgents /absolute/path/to/consulting-agents-mcp/start_mcp_server.sh

  2. 启动Claude Code 并启用MCP集成：

    claude --mcp-debug

  3. 在Claude Code中使用工具：

    现在你可以使用consult_with_darren、consult_with_sonny、consult_with_sergey 和 consult_with_gemma 函数。

可用工具

MCP服务器提供四个咨询工具：

consult_with_darren

使用具有高推理能力的OpenAI o3-mini模型来分析代码并提供建议。

参数：

  • consultation_context：问题描述（必需）
  • source_code：可选代码以供分析

consult_with_sonny

使用具有增强思考能力的Claude 3.7 Sonnet模型提供深入的代码分析。

参数：

  • consultation_context：问题描述（必需）
  • source_code：可选代码以供分析

注意：由于Claude Code现在具有原生扩展思考模式，这个代理有些冗余，但仍然可能有用，可以获取来自另一个Claude模型的不同意见或方法。

consult_with_sergey

使用具有网络搜索能力的GPT-4o模型来查找相关信息和文档。

参数：

  • consultation_context：你需要什么信息或文档的描述（必需）
  • search_query：可选的具体搜索查询
  • source_code：可选的代码以供上下文

注意：由于Claude Code现在具有原生网络搜索能力，这个代理有些冗余，但仍然可能有用，可以比较GPT-4o和Claude之间的搜索结果，或者获取不同的观点。

consult_with_gemma

使用具有1M令牌上下文窗口的Google Gemini 2.5 Pro模型来分析整个仓库，并提供全面的开发计划。

参数：

  • consultation_context：要实施的任务或特性的描述（必需）
  • repo_url：要分析的GitHub仓库URL（必需） - 重要：始终指定完整的正确GitHub URL（例如，“https://github.com/username/repo”）
  • feature_description：要实现的功能的详细描述（必需）

注意：这个代理特别有用，因为Claude Code本身没有能力在一个上下文中分析整个仓库。

重要URL规范：使用Gemma时，始终提供确切的GitHub仓库URL。Claude Code可能会从你的本地目录路径错误地推断出仓库URL，这可能导致仓库访问错误。URL应采用https://github.com/username/repository的形式，并且具有正确的大小写敏感性。

高级配置

环境变量

  • MCP_TRANSPORT：传输协议（默认：“stdio”，替代：“http”，“sse”）
  • HOST：使用HTTP/SSE传输时的服务器主机（默认：“127.0.0.1”）
  • PORT：使用HTTP/SSE传输时的服务器端口（默认：5000）

HTTP API（当使用HTTP传输时）

当使用HTTP传输运行时，服务器提供以下端点：

健康检查

GET /health

返回服务器状态和可用代理。

模型咨询

POST /consult

Darren或Sonny请求体：

{
  "agent": "Darren",
  "consultation_context": "我在代码中有一个bug，其中...",
  "source_code": "def example():\n    return 'hello'"
}

Sergey请求体：

{
  "agent": "Sergey",
  "consultation_context": "如何在Express中实现JWT认证？",
  "search_query": "express.js JWT auth implementation"
}

Gemma请求体：

{
  "agent": "Gemma",
  "consultation_context": "为API添加用户认证",
  "repo_url": "https://github.com/username/repo",
  "feature_description": "实现基本的用户名/密码API访问认证"
}

重要：在repo_url字段中始终提供确切和完整的GitHub仓库URL。不要依赖Claude Code从你的本地目录路径推断这一点。

故障排除

  • 未找到MCP服务器：验证你在claude mcp add命令中的绝对路径
  • API认证错误：检查你的API密钥是否在.env文件中正确设置
  • 连接问题：确保在启动Claude Code之前MCP服务器正在运行
  • 调试日志：检查MCP服务器运行的终端中的详细日志

更新到新版本

更新到consulting-agents-mcp的新版本时，请遵循以下步骤：

  1. 更新仓库代码（拉取最新更改）
  2. 重启MCP服务器： 
    ./start_mcp_server.sh
  3. 从Claude Code中移除现有的MCP服务器： 
    claude mcp remove ConsultingAgents
  4. 使用绝对路径重新添加MCP服务器到Claude Code： 
    claude mcp add ConsultingAgents /absolute/path/to/consulting-agents-mcp/start_mcp_server.sh

此过程确保Claude Code使用的是更新版本的MCP服务器及其任何新的模型或功能。

开发

在开发模式下运行

  1. 启动带有调试输出的服务器：

    DEBUG=true ./start_mcp_server.sh

  2. 测试HTTP端点（当使用HTTP传输时）：

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

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

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

# 测试Gemma
curl -X POST http://localhost:5000/consult \
  -H "Content-Type: application/json" \
  -d '{"agent":"Gemma","consultation_context":"添加用户认证","repo_url":"https://github.com/username/repo","feature_description":"实现基本的用户名/密码API访问认证"}'

项目结构

  • mcp_consul_server.py：主要的MCP服务器实现
  • start_mcp_server.sh：启动服务器的脚本，带有适当的环境
  • requirements.txt：Python依赖项

许可证

MIT

贡献

欢迎贡献！请随时提交Pull Request。