Customer Care MCP Server

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 

例子：

/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