使用说明
MCP多代理客户服务和网络搜索服务器
📌 概述
该项目是一个多代理MCP服务器，旨在与Puch AI集成。 它模拟了一个客户服务系统和一个网络搜索引擎，两者都由主管代理协调。 该系统还允许人工参与需要人工干预的决策。
架构：
主管代理→ 决定查询应由客户服务代理还是Web搜索代理处理。
客户服务代理→ 回答与产品、订单或帐户帮助相关的问题。
Web搜索代理→ 对用户查询执行web搜索。
循环中的人类→ 当主管将案件标记为需要人工审查时，参与其中。
⚙ 特性
多代理编排（主管→ 专业代理）
网络搜索集成（DuckDuckGo或Google通过API）
客户服务响应与上下文
用于身份验证和工具发现的Puch AI MCP协议
发送某些响应前的人工批准机制
为Vercel、Cloudflare或Ngrok准备好安全的HTTPS部署
📂 文件结构
mcp-multi-agent-server/
│── .env.example # Environment variables template
│── requirements.txt # Python dependencies
│── README.md # Project documentation
│── server.py # MCP server main entry point
│── agents/
│ ├── __init__.py
│ ├── supervisor.py # Supervisor logic
│ ├── customer_care.py # Customer care agent
│ ├── web_search.py # Web search agent
│── utils/
│ ├── __init__.py
│ ├── fetch.py # HTTP fetching utilities
│ ├── auth.py # Bearer token authentication
🔑 环境变量
创建.env文件：
AUTH_TOKEN=your_secret_token
MY_NUMBER=919876543210
📦 安装
克隆仓库
git clone https://github.com/your-username/mcp-multi-agent-server.git
cd mcp-multi-agent-server
Install dependencies
pip install -r requirements.txt
Set up environment variables
cp .env
使用您的值编辑.env
🚀 本地运行
python server.py
服务器将在以下时间启动：
http://0.0.0.0:8086
🌍 通过HTTPS部署
对于公共访问，您必须通过HTTPS提供服务：
ngrok http 8086
Vercel / Cloudflare
部署为无服务器功能。
确保在部署环境中设置了.env变量。
🔌 与Puch AI连接
要连接，请执行以下操作：
/mcp connect https://your-ngrok-or-domain/mcp <AUTH_TOKEN>
例子：
/mcp connect https://abcd-1234.ngrok.io/mcp mysecrettoken
🛠 MCP中的工具
验证→ Puch AI要求进行身份验证。
客户关怀→ 处理支持查询。
网络搜索→ 搜索互联网。
监督人→ 将请求路由到正确的代理或人员。
📚 工作流示例
用户发送查询→ MCP服务器接收它。
主管决定：
“我的订单在哪里？”→ 客户服务代理。
“最新iPhone评论”→ Web搜索代理。
“敏感退款案例”→ 需要人工批准。
回复已发送回Puch AI。
塞勒
在渲染上部署： https://customer-care-mcp-server.onrender.com
🤝 贡献
欢迎拉取请求！拜托：
分叉回购
创建要素分支
提交PR
📜 许可证
麻省理工学院许可证©2025