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 文档。

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

hello_tool

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

Related MCP Servers

Warpcast MCP Server
zhangzhongnan928
-
security
A
license
-
quality
A Model Context Protocol server that allows Claude to interact with Warpcast accounts, enabling actions like posting casts, reading content, searching by keywords, and managing channel interactions through natural language.
Last updated -
3
Python
MIT License
API Tester MCP Server
Vikrant-Khedkar
-
security
F
license
-
quality
A Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.
Last updated -
Python
WhatsApp Web MCP
fyimail
-
security
A
license
-
quality
A bridge that connects WhatsApp Web to AI models using the Model Context Protocol, enabling Claude and other AI systems to interact with WhatsApp through a standardized interface.
Last updated -
25
6
TypeScript
MIT License
WhatsApp MCP Server
jlucaso1
-
security
F
license
-
quality
A Model Context Protocol server that connects your personal WhatsApp account to AI agents like Claude, enabling them to search messages, view contacts, retrieve chat history, and send messages via WhatsApp.
Last updated -
34
TypeScript

View all related MCP servers

MCP Evolution API

MCP 演进 API

概述

📂 项目结构

🚀 快速设置

环境设置

📋 部署选项

Claude桌面配置

📊 实施状态

Tools

Related MCP Servers

Warpcast MCP Server

API Tester MCP Server

WhatsApp Web MCP

WhatsApp MCP Server

Appeared in Searches

New MCP Servers

MCP directory API