MCP 演进 API

用于 Claude 的模型上下文协议 (MCP) 服务器与Evolution API集成以实现 WhatsApp 自动化。

概述

该 MCP 服务器允许 Claude 通过 Evolution API 与 WhatsApp 进行交互，从而实现以下功能：

管理 WhatsApp 实例
发送各种类型的消息
与联系人和群组合作
配置 webhook 和设置

📂 项目结构

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

🚀 快速设置

环境设置

使用您的 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 install` `bun run dev`
本地生产	1. 克隆并安装2. 构建并运行	`git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && 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	构建并运行容器	`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 集成❌ Evolution Bot❌ Dify Bot❌ Flowise Bot
其他集成		❌Chatwoot❌Websocket❌SQS❌RabbitMQ

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

MCP Evolution API

Integrations