小贴士:按下Ctrl+D 或 ⌘+D,一键收藏本站,方便下次快速访问!
MIT License
9
最近更新:1年前

MCP 服务器用于 evolution,这是 WhatsApp 的非官方 API。

MCP Evolution API

一个用于 Claude 的 Model Context Protocol (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          # 校验配置
├── 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. 克隆并安装
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 Desktop 配置

将以下内容添加到您的 Claude Desktop 配置文件(通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json):

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

如果使用 Docker 部署:

json 复制代码
{
  "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 文档