Mcp Evolution Api

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.2更新於 Oct 24, 2026

MCP server for Evolution API — WhatsApp messaging, instances, contacts

已驗證STDIO僅桌面效率與工作流溝通與協作

概覽

AI 產生的概覽

本機 MCP 伺服器，將助理連接到自架的 Evolution API 執行個體，用來傳送 WhatsApp 訊息並管理執行個體、聯絡人與群組。

可以做什麼
傳送 WhatsApp 文字、圖片、文件與投票訊息，將訊息標為已讀，或為自己或所有人刪除訊息。列出、建立、重新啟動、登出或刪除 WhatsApp 執行個體，取得配對 QR 碼並查詢連線狀態。讀取聯絡人、聊天記錄與訊息，並檢查手機號碼是否已註冊 WhatsApp。建立群組、讀取群組中繼資料、取得邀請碼、退出群組，以及新增、移除、提升或降級群組成員。更新執行個體個人檔案、設定在線狀態，以及封存或取消封存聊天。
適用情境
適合自架 Evolution API 執行個體、希望助理在對話中草擬並傳送 WhatsApp 訊息、查詢聊天與聯絡人，或管理 WhatsApp 執行個體與群組的情境。
執行需求
透過 npx 在本機執行（需要 Node.js）。需要一個可連線的自架 Evolution API 執行個體，以環境變數 EVOLUTION_API_URL 指定，並以 EVOLUTION_API_KEY 提供 API 金鑰。README 建議以 Docker 部署執行個體以便測試。
安裝前請注意
此伺服器可向真實 WhatsApp 聯絡人傳送訊息與投票、建立與刪除執行個體、變更群組成員，並為所有人刪除訊息，這些操作難以復原。它持有可控制 WhatsApp 執行個體的 API 金鑰，請勿放入共用設定。訊息內容與聯絡人資料會經過你的 Evolution API 執行個體。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Evolution Api，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@codespar/mcp-evolution-api

MCP server for Evolution API — self-hosted WhatsApp messaging API

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "evolution-api": {      "command": "npx",      "args": ["-y", "@codespar/mcp-evolution-api"],      "env": {        "EVOLUTION_API_URL": "https://your-instance.example.com",        "EVOLUTION_API_KEY": "your-key"      }    }  }}

Claude Code

bash
claude mcp add evolution-api -- npx @codespar/mcp-evolution-api

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "evolution-api": {      "command": "npx",      "args": ["-y", "@codespar/mcp-evolution-api"],      "env": {        "EVOLUTION_API_URL": "https://your-instance.example.com",        "EVOLUTION_API_KEY": "your-key"      }    }  }}

Tools (25)

ToolPurpose
send_textSend a text message via WhatsApp
send_imageSend an image message via WhatsApp
send_documentSend a document via WhatsApp
get_instancesList all WhatsApp instances
create_instanceCreate a new WhatsApp instance
get_qrcodeGet QR code for instance pairing
get_contactsGet contacts from an instance
send_pollSend a poll message via WhatsApp
get_messagesGet messages from a chat
check_numberCheck if a phone number is registered on WhatsApp
create_groupCreate a WhatsApp group
get_group_infoGet group metadata, participants, and settings
update_profileUpdate instance profile (name, status text, or picture)
set_presenceSet online/offline presence for an instance
get_chat_historyGet full chat history with pagination support
logout_instanceLogout an instance (disconnects the WhatsApp session without deleting the instance)
restart_instanceRestart an instance
delete_instanceDelete an instance permanently
connection_stateGet the connection state of an instance (open, connecting, close)
leave_groupLeave a WhatsApp group
update_group_participantsAdd, remove, promote, or demote participants in a WhatsApp group
fetch_group_invite_codeFetch the invite code/link for a WhatsApp group
mark_message_as_readMark one or more messages in a chat as read
archive_chatArchive or unarchive a chat
delete_messageDelete a message for me or for everyone in a chat

Authentication

Evolution API uses an API key passed via the apikey header.

Sandbox / Testing

Evolution API is self-hosted. Deploy your own instance using Docker for testing.

Get your credentials

  1. Go to Evolution API Documentation
  2. Deploy your own instance (Docker recommended)
  3. Get the API key from your instance configuration
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
EVOLUTION_API_URLYesBase URL of your Evolution API instance
EVOLUTION_API_KEYYesAPI key for authentication

Roadmap

v0.2 (planned)

  • create_group — Create a WhatsApp group
  • get_group_info — Get group details and participants
  • update_profile — Update instance profile (name, photo, status)
  • set_presence — Set online/offline presence status
  • get_chat_history — Get full chat history with a contact

v0.3 (planned)

  • bulk_send — Send messages to multiple contacts
  • template_messages — Send WhatsApp Business template messages
  • label_management — Create, update, and assign labels to chats

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

來源：packages/communication/evolution-api/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分