AI导哈

WhatsApp自动化API

一个通过Evolution API实现WhatsApp自动化的MCP服务器，支持消息发送、联系人管理、群组操作等功能。

  • by fellipesaraiva88
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 fellipesaraiva88/mcp-evo

使用说明

MCP演进API

一种用于Claude的模型上下文协议（MCP）服务器，与 进化API WhatsApp自动化。

概述

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

  • 管理WhatsApp实例
  • 发送各种类型的消息
  • 与联系人和团体合作
  • 配置webhooks和设置

📂 项目结构

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

🚀 快速设置

环境设置

创建一个 .env 使用您的Evolution API证书提交文件：

EVOLUTION_API_URL=https://your-evolution-api-server.com
EVOLUTION_API_KEY=your-api-key-here

📋 部署选项

环境 步骤 命令
地方发展 1.克隆并安装
2.在开发模式下运行		 git clone https://github.com/fellipesaraiva88/mcp-evolution-whatsapp-api_v2.git && cd mcp-evolution-whatsapp-api_v2 && bun install
bun run dev
本地生产 1.克隆并安装
2.构建和运行		 git clone https://github.com/aiteks-ltda/mcp-evolution-whatsapp-api_v2.git && cd mcp-evolution-whatsapp-api_v2 && 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 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集成
❌ 进化机器人
❌ Dify BOT
❌ Flowise机器人
其他集成 ❌ 查特沃特
❌ WebSocket
❌ 平方英尺
❌ RabbitMQ

有关更多信息，请参阅 API发展文档.

相关 MCP