
Evolution Whatsapp Api
MCP 服务器用于 evolution,这是 WhatsApp 的非官方 API。
概述
MCP Evolution API
一个用于 Claude 的 Model Context Protocol (MCP) 服务器,集成 Evolution API 实现 WhatsApp 自动化。
概述
此 MCP 服务器允许 Claude 通过 Evolution API 与 WhatsApp 交互,支持以下功能:
- 管理 WhatsApp 实例
- 发送各种类型的消息
- 处理联系人和群组
- 配置 Webhook 和设置
📂 项目结构
mcp-evo-api/
├── src/
│ ├── tools/ # Evolution API 的 MCP 工具实现
│ ├── utils/ # 共享工具,包括 Evolution API 客户端
│ ├── main.ts # 服务器入口点
│ └── types.ts # 共享类型定义
├── scripts/ # 辅助脚本
├── biome.json # 校验配置
├── tsconfig.json # TypeScript 配置
├── docker-compose.yml # Docker Compose 配置
├── Dockerfile # Docker 构建配置
└── package.json # 项目依赖
🚀 快速设置
环境设置
创建一个包含 Evolution API 凭据的 .env 文件:
EVOLUTION_API_URL=https://your-evolution-api-server.com
EVOLUTION_API_KEY=your-api-key-here
📋 部署选项
| 环境 | 步骤 | 命令 |
|---|---|---|
| 本地开发 | 1. 克隆并安装 2. 以开发模式运行 |
git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun installbun run dev |
| 本地生产 | 1. 克隆并安装 2. 构建并运行 |
git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun installbun 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-apidocker-compose up -d |
| Docker | 构建并运行容器 | 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 Desktop 配置
将以下内容添加到您的 Claude Desktop 配置文件(通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json):
json
{
"mcpServers": {
"evo-api": {
"command": "node",
"args": [
"/path/to/your/mcp-evo-api/dist/main.js"
]
}
}
}
如果使用 Docker 部署:
json
{
"mcpServers": {
"evo-api": {
"url": "http://localhost:3000"
}
}
}
📊 实现状态
| 类别 | 已实现 | 待实现 |
|---|---|---|
| 核心 API | ✅ 获取信息 ✅ 创建实例 ✅ 获取实例 ✅ 实例连接 ✅ 重启实例 ✅ 连接状态 ✅ 登出实例 ✅ 删除实例 ✅ 设置在线状态 |
❌ 检查是否为 WhatsApp |
| Webhook & 设置 | ✅ 设置 Webhook ✅ 查找 Webhook ✅ 设置设置 ✅ 查找设置 |
|
| 消息 | ✅ 发送纯文本 ✅ 发送状态 ✅ 发送媒体 ✅ 发送 WhatsApp 音频 ✅ 发送贴纸 ✅ 发送位置 ✅ 发送联系人 ✅ 发送反应 ✅ 发送投票 ✅ 发送列表 ✅ 发送按钮 |
❌ 标记消息为已读 ❌ 标记消息为未读 ❌ 归档聊天 ❌ 删除对所有人可见的消息 ❌ 更新消息 ❌ 发送在线状态(聊天控制) |
| 聊天 & 联系人 | ✅ 查找联系人 ✅ 查找聊天 |
❌ 更新阻止状态 ❌ 获取头像 URL ❌ 获取 Base64 ❌ 查找消息 ❌ 查找状态消息 |
| 群组 | ✅ 按 JID 查找群组 ✅ 获取所有群组 ✅ 查找群组成员 |
❌ 创建群组 ❌ 更新群组头像 ❌ 更新群组主题 ❌ 更新群组描述 ❌ 获取邀请码 ❌ 撤销邀请码 ❌ 发送群组邀请 ❌ 按邀请码查找群组 ❌ 更新群组成员 ❌ 更新群组设置 ❌ 切换临时消息 ❌ 离开群组 |
| 个人资料设置 | ❌ 获取商业个人资料 ❌ 获取个人资料 ❌ 更新个人资料名称 ❌ 更新个人资料状态 ❌ 更新个人资料头像 ❌ 删除个人资料头像 ❌ 获取隐私设置 ❌ 更新隐私设置 |
|
| 机器人集成 | ❌ Typebot 集成 ❌ OpenAI 集成 ❌ Evolution Bot ❌ Dify Bot ❌ Flowise Bot |
|
| 其他集成 | ❌ Chatwoot ❌ Websocket ❌ SQS ❌ RabbitMQ |
如需更多信息,请参考 Evolution API 文档。

Ai Cursor Scraping Assistant
一个强大的工具,利用 Cursor AI 和 MCP(模型上下文协议)轻松为各种类型的网站生成网络爬虫。
Ai Customer Support Bot Mcp Server
一个模型上下文协议(MCP)服务器,使用Cursor AI和Glama.ai集成提供由AI驱动的客户服务。
All In One Model Context Protocol
🚀 集成 AI 搜索、RAG 和多服务集成(GitLab/Jira/Confluence/YouTube)的一体化 MCP 服务器,用于增强开发工作流程
Arxiv Search Mcp
一个提供从 arXiv.org 搜索和获取论文工具的 MCP 服务器。
