MCP Evolution API

一个与Evolution API集成的用于Claude的Model Context Protocol (MCP)服务器，用于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://evo-api.decisao.ai/
EVOLUTION_API_KEY=REPLACE_WITH_YOUR_REAL_KEY

注意：您提供了API URL和密钥。出于安全考虑，请勿将真实的API密钥提交到仓库或公开分享。在生产环境中使用本地.env文件或密钥管理器。

📋 部署选项

环境	步骤	命令
本地开发	1. 克隆并安装<br>2. 开发模式运行	git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-e-vo-api && bun install<br>bun run dev
本地生产	1. 克隆并安装<br>2. 构建并运行	git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun install<br>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<br>docker-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）：

{
  "mcpServers": {
    "evo-api": {
      "command": "node",
      "args": [
        "/path/to/your/mcp-evo-api/dist/main.js"
      ]
    }
  }
}

如果使用Docker部署：

{
  "mcpServers": {
    "evo-api": {
      "url": "http://localhost:3000"
    }
  }
}

📊 实现状态

类别	已实现	待实现
核心API	✅ 获取信息<br>✅ 创建实例<br>✅ 获取实例<br>✅ 实例连接<br>✅ 重启实例<br>✅ 连接状态<br>✅ 登出实例<br>✅ 删除实例<br>✅ 设置在线状态	❌ 检查是否是WhatsApp
Webhook & 设置	✅ 设置Webhook<br>✅ 查找Webhook<br>✅ 设置设置<br>✅ 查找设置
消息	✅ 发送纯文本<br>✅ 发送状态<br>✅ 发送媒体<br>✅ 发送WhatsApp音频<br>✅ 发送贴纸<br>✅ 发送位置<br>✅ 发送联系人<br>✅ 发送反应<br>✅ 发送投票<br>✅ 发送列表<br>✅ 发送按钮	❌ 标记消息为已读<br>❌ 标记消息为未读<br>❌ 归档聊天<br>❌ 删除所有人消息<br>❌ 更新消息<br>❌ 发送在线状态（聊天控制）
聊天&联系人	✅ 查找联系人<br>✅ 查找聊天	❌ 更新屏蔽状态<br>❌ 获取个人资料图片URL<br>❌ 获取Base64<br>❌ 查找消息<br>❌ 查找状态消息
群组	✅ 通过JID查找群组<br>✅ 获取所有群组<br>✅ 查找群成员	❌ 创建群组<br>❌ 更新群组图片<br>❌ 更新群组主题<br>❌ 更新群组描述<br>❌ 获取邀请码<br>❌ 撤销邀请码<br>❌ 发送群组邀请<br>❌ 通过邀请码查找群组<br>❌ 更新群成员<br>❌ 更新群设置<br>❌ 切换临时消息<br>❌ 离开群组
个人资料设置		❌ 获取企业资料<br>❌ 获取个人资料<br>❌ 更新个人资料名称<br>❌ 更新个人资料状态<br>❌ 更新个人资料图片<br>❌ 移除个人资料图片<br>❌ 获取隐私设置<br>❌ 更新隐私设置
机器人集成		❌ Typebot集成<br>❌ OpenAI集成<br>❌ Evolution Bot<br>❌ Dify Bot<br>❌ Flowise Bot
其他集成		❌ Chatwoot<br>❌ WebSocket<br>❌ SQS<br>❌ RabbitMQ

更多信息，请参阅Evolution API 文档。

示例

• examples/hono-bun/ - 小型Hono服务器用于Bun（保存示例）。请参阅examples/hono-bun/README.md以获取执行说明。