MCP Evolution API

一个用于 Claude 的模型上下文协议 (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          # Linting 配置
├── 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. 克隆并安装<br>2. 在开发模式下运行	git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-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>❌ 更新隐私设置
Bot 集成		❌ Typebot 集成<br>❌ OpenAI 集成<br>❌ Evolution Bot<br>❌ Dify Bot<br>❌ Flowise Bot
其他集成		❌ Chatwoot<br>❌ Websocket<br>❌ SQS<br>❌ RabbitMQ

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