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。