M

MCP Evolution WhatsApp接口

@aiteks-ltda/mcp-evolution-whatsapp-api
1 Stars 19 次浏览 aiteks-ltda 更新于 2026-08-23

一种模型上下文协议服务器，它使克劳德能够通过进化API与WhatsApp交互，从而实现消息发送、联系人管理、群组操作和WhatsApp实例管理。

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

MCP Evolution API

一个用于 Claude 的 Model Context Protocol (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 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 桌面配置

将以下内容添加到您的 Claude 桌面配置文件中（通常位于 ~/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 文档。

查看源码 项目主页