MCP演进API
一种用于Claude的模型上下文协议(MCP)服务器,与 进化API WhatsApp自动化。
概述
此MCP服务器允许Claude通过Evolution API与WhatsApp进行交互,实现以下功能:
- 管理WhatsApp实例
- 发送各种类型的消息
- 与联系人和团体合作
- 配置webhooks和设置
📂 项目结构
mcp-evo-api/
├── src/
│ ├── tools/ # MCP tools implementation for Evolution API
│ ├── utils/ # Shared utilities, including Evolution API client
│ ├── main.ts # Server entry point
│ └── types.ts # Shared type definitions
├── scripts/ # Helper scripts
├── biome.json # Linting configuration
├── tsconfig.json # TypeScript configuration
├── docker-compose.yml # Docker Compose configuration
├── Dockerfile # Docker build configuration
└── package.json # Project dependencies🚀 快速设置
环境设置
创建一个 .env 使用您的Evolution API证书提交文件:
EVOLUTION_API_URL=https://your-evolution-api-server.com
EVOLUTION_API_KEY=your-api-key-here📋 部署选项
| 环境 | 步骤 | 命令 |
|---|---|---|
| 地方发展 1.克隆并安装 | ||
| 2.在开发模式下运行 | git clone https://github.com/fellipesaraiva88/mcp-evolution-whatsapp-api_v2.git && cd mcp-evolution-whatsapp-api_v2 && bun install | |
bun run dev | ||
| 本地生产 1.克隆并安装 | ||
| 2.构建和运行 | git clone https://github.com/aiteks-ltda/mcp-evolution-whatsapp-api_v2.git && cd mcp-evolution-whatsapp-api_v2 && bun install | |
bun run build && bun run dist/main.js | ||
| Docker Compose | 使用Docker Compose运行 | git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api |
docker-compose up -d | ||
| 码头工人 | 构建并运行容器 | docker run -d -p 3000:3000 -e EVOLUTION_API_URL=yoururl -e EVOLUTION_API_KEY=yourkey --name mcp-evo-api ghcr.io/aiteks-ltda/mcp-evo-api:latest |
Claude桌面配置
将此添加到您的Claude Desktop配置文件中(通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"evo-api": {
"command": "node",
"args": [
"/path/to/your/mcp-evo-api/dist/main.js"
]
}
}
}如果使用Docker部署:
{
"mcpServers": {
"evo-api": {
"url": "http://localhost:3000"
}
}
}📊 实施状态
| 类别 | 已实施 | 待实施 |
|---|---|---|
| 核心api | ✅ 获取信息 |
✅ 创建实例 ✅ 获取实例 ✅ 实例连接 ✅ 重新启动实例 ✅ 连接状态 ✅ 注销实例 ✅ 删除实例 ✅ 设置状态|❌ 检查是WhatsApp| | Webhook和设置 | ✅ 设置Webhook ✅ 查找Webhook ✅ 设置设置 ✅ 查找设置|| | 消息传递 | ✅ 发送纯文本 ✅ 发送状态 ✅ 发送媒体 ✅ 发送WhatsApp音频 ✅ 发送贴纸 ✅ 发送位置 ✅ 发送联系人 ✅ 发送反应 ✅ 发送投票 ✅ 发送列表 ✅ 发送按钮|❌ 将邮件标记为已读 ❌ 将邮件标记为未读 ❌ 存档聊天 ❌ 删除所有人的邮件 ❌ 更新消息 ❌ 发送状态信息(聊天控制键)| | 聊天和联系人 | ✅ 查找联系人 ✅ 查找聊天记录|❌ 更新块状态 ❌ 获取个人资料图片URL ❌ 获取Base64 ❌ 查找消息 ❌ 查找状态消息| | 群组 | ✅ 按JID查找组 ✅ 获取所有组 ✅ 查找组成员|❌ 创建群组 ❌ 更新群组图片 ❌ 更新组主题 ❌ 更新组描述 ❌ 获取邀请码 ❌ 撤销邀请码 ❌ 发送群组邀请 ❌ 按邀请码查找组 ❌ 更新组成员 ❌ 更新组设置 ❌ 切换短暂 ❌ 离开集团| | 配置文件设置 | | ❌ 获取业务简介 ❌ 获取个人资料 ❌ 更新配置文件名称 ❌ 更新配置文件状态 ❌ 更新个人资料图片 ❌ 删除个人资料图片 ❌ 获取隐私设置 ❌ 更新隐私设置| | 机器人集成 | | ❌ Typebot集成 ❌ OpenAI集成 ❌ 进化机器人 ❌ Dify BOT ❌ Flowise机器人| | 其他集成 | | ❌ 查特沃特 ❌ WebSocket ❌ 平方英尺 ❌ RabbitMQ |
有关更多信息,请参阅 API发展文档.
