de en es ja ko ru zh

mcp-evolution

Name: mcp-evolution
Author: billyfranklim1

by billyfranklim1

Overview Schema Related Servers Score Discussions

TypeScript

Remote

mcp-evolution

npm version license

インスタンス固定機能を備えたEvolution API（WhatsApp）用TypeScript MCPサーバー。

アーキテクチャ

このサーバーはModel Context Protocolを実装しています：

トランスポート: stdio — MCPホスト（Claude Desktop、Claude Codeなど）がこのプロセスを起動し、stdin/stdout経由でJSON-RPC通信を行います。
サーバー: 公式TypeScript SDKの高レベルな McpServer クラスを使用しており、機能ネゴシエーションとセッションライフサイクルを自動的に処理します。
ツール: Zodで検証された入力スキーマを持つ50個のツールが registerTool() を通じて登録されており、ハンドラー実行前にSDKが型を強制します。

3つの接続パラメータ（API URL、APIキー、インスタンス名）はすべて、起動時に環境変数を通じて固定されます。AI呼び出し元が会話の途中でインスタンスを切り替えることはできません。

Related MCP server: mcp-evolution-api

ツール

メッセージ

ツール	説明
`send_text`	プレーンテキストメッセージを送信
`send_media`	画像、動画、音声、またはドキュメントを送信
`send_audio`	WhatsApp音声（PTTボイスノート）を送信
`send_sticker`	ステッカー（webp）を送信
`send_location`	位置情報ピンを送信
`send_contact`	1つ以上の連絡先（vCard）を共有
`send_reaction`	絵文字でメッセージにリアクション
`send_poll`	アンケートメッセージを送信
`send_list`	インタラクティブなリスト/メニューメッセージを送信
`send_button`	インタラクティブなボタンメッセージを送信
`send_status`	WhatsAppステータス（ストーリー）を投稿

チャット

ツール	説明
`find_chats`	チャットを検索（Prisma形式の `where` 句でフィルタリング可能）
`find_contacts`	連絡先を検索（フィルタリング可能）
`find_messages`	remoteJidでメッセージを検索（制限付き）
`get_chat_history`	連絡先またはグループJIDのメッセージ履歴を取得
`mark_as_read`	1つ以上のメッセージを既読にする
`archive_chat`	チャットをアーカイブまたはアーカイブ解除
`delete_message`	全員に対してメッセージを削除
`fetch_profile_picture`	連絡先のプロフィール画像URLを取得
`download_media`	メッセージからメディアをbase64としてダウンロード
`send_presence`	プレゼンス更新（入力中、録音中など）を送信
`check_number`	電話番号にWhatsAppアカウントがあるか確認

プロフィール

ツール	説明
`fetch_business_profile`	連絡先のWhatsAppビジネスプロフィールを取得
`update_profile_name`	インスタンスの表示名を更新
`update_profile_status`	インスタンスのステータス/概要テキストを更新
`update_profile_picture`	インスタンスのプロフィール画像を更新
`remove_profile_picture`	インスタンスのプロフィール画像を削除
`fetch_privacy`	現在のプライバシー設定を取得
`update_privacy`	プライバシー設定を更新
`update_block_status`	連絡先をブロックまたはブロック解除

グループ

ツール	説明
`list_groups`	固定されたインスタンスのすべてのWhatsAppグループを一覧表示
`get_group_info`	JIDで特定のグループの詳細情報を取得
`create_group`	新しいWhatsAppグループを作成
`update_group_subject`	グループ名を更新
`update_group_description`	グループの説明を更新
`update_group_picture`	グループのプロフィール画像を更新
`fetch_invite_code`	グループの招待コード/リンクを取得
`revoke_invite_code`	グループの招待コードを無効化して再生成
`accept_invite`	コードでグループ招待を承諾
`send_group_invite`	特定の連絡先にグループ招待リンクを送信
`update_participants`	グループ参加者の追加、削除、昇格、降格
`update_group_setting`	グループ設定（アナウンスモード、ロック）を更新
`leave_group`	グループを退出
`find_group_by_invite`	参加せずに招待コードからグループ情報を取得

インスタンス

ツール	説明
`connection_state`	インスタンスの現在の接続状態を取得
`restart_instance`	インスタンスを再起動（ログアウトせずに再接続）
`logout_instance`	インスタンスをログアウト（セッションをクリア）
`get_settings`	現在のインスタンス設定を取得
`set_settings`	インスタンス設定を更新

Webhook

ツール	説明
`find_webhook`	現在のWebhook設定を取得
`set_webhook`	Webhookを設定

ラベル

ツール	説明
`find_labels`	すべてのラベルを一覧表示（WhatsApp Businessが必要）
`handle_label`	チャットにラベルを追加または削除

npx経由でのインストールと実行

EVOLUTION_API_URL=http://localhost:8080 \
EVOLUTION_API_KEY=your-key \
EVOLUTION_INSTANCE=your-instance \
npx mcp-evolution

設定

変数	必須	説明
`EVOLUTION_API_URL`	はい	Evolution APIのベースURL（例: `http://localhost:8080`）
`EVOLUTION_API_KEY`	はい	Evolution API設定からのグローバルAPIキー
`EVOLUTION_INSTANCE`	はい	Evolution APIで作成されたインスタンス名

ローカル開発用に .env.example を .env にコピーしてください。

Claude Desktop / Claude Codeでの使用

~/.claude/claude_desktop_config.json またはプロジェクトの .mcp.json に追加してください：

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["mcp-evolution"],
      "env": {
        "EVOLUTION_API_URL": "http://localhost:8080",
        "EVOLUTION_API_KEY": "your-evolution-api-key",
        "EVOLUTION_INSTANCE": "your-instance-name"
      }
    }
  }
}

または、ローカルチェックアウトから実行する場合は、ビルドされたバイナリを直接指定してください：

{
  "mcpServers": {
    "whatsapp": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-evolution/dist/index.js"],
      "env": {
        "EVOLUTION_API_URL": "http://localhost:8080",
        "EVOLUTION_API_KEY": "your-evolution-api-key",
        "EVOLUTION_INSTANCE": "your-instance-name"
      }
    }
  }
}

開発

# Install dependencies
npm install

# Run in dev mode (no build step)
npm run dev

# Build TypeScript → dist/
npm run build

# Run tests
npm test

# Start from built output
npm start

ラップされたEvolution APIエンドポイント

ツール	メソッド	パス
`send_text`	POST	`/message/sendText/{instance}`
`send_media`	POST	`/message/sendMedia/{instance}`
`send_audio`	POST	`/message/sendWhatsAppAudio/{instance}`
`send_sticker`	POST	`/message/sendSticker/{instance}`
`send_location`	POST	`/message/sendLocation/{instance}`
`send_contact`	POST	`/message/sendContact/{instance}`
`send_reaction`	POST	`/message/sendReaction/{instance}`
`send_poll`	POST	`/message/sendPoll/{instance}`
`send_list`	POST	`/message/sendList/{instance}`
`send_button`	POST	`/message/sendButtons/{instance}`
`send_status`	POST	`/message/sendStatus/{instance}`
`find_chats`	POST	`/chat/findChats/{instance}`
`find_contacts`	POST	`/chat/findContacts/{instance}`
`find_messages` / `get_chat_history`	POST	`/chat/findMessages/{instance}`
`mark_as_read`	POST	`/chat/markMessageAsRead/{instance}`
`archive_chat`	POST	`/chat/archiveChat/{instance}`
`delete_message`	DELETE	`/chat/deleteMessageForEveryone/{instance}`
`fetch_profile_picture`	POST	`/chat/fetchProfilePictureUrl/{instance}`
`download_media`	POST	`/chat/getBase64FromMediaMessage/{instance}`
`send_presence`	POST	`/chat/sendPresence/{instance}`
`check_number`	POST	`/chat/whatsappNumbers/{instance}`
`fetch_business_profile`	POST	`/chat/fetchBusinessProfile/{instance}`
`update_profile_name`	POST	`/chat/updateProfileName/{instance}`
`update_profile_status`	POST	`/chat/updateProfileStatus/{instance}`
`update_profile_picture`	POST	`/chat/updateProfilePicture/{instance}`
`remove_profile_picture`	DELETE	`/chat/removeProfilePicture/{instance}`
`fetch_privacy`	GET	`/chat/fetchPrivacySettings/{instance}`
`update_privacy`	POST	`/chat/updatePrivacySettings/{instance}`
`update_block_status`	POST	`/chat/updateBlockStatus/{instance}`
`list_groups`	GET	`/group/fetchAllGroups/{instance}`
`get_group_info`	GET	`/group/findGroupInfos/{instance}`
`create_group`	POST	`/group/create/{instance}`
`update_group_subject`	POST	`/group/updateGroupSubject/{instance}?groupJid=`
`update_group_description`	POST	`/group/updateGroupDescription/{instance}?groupJid=`
`update_group_picture`	POST	`/group/updateGroupPicture/{instance}?groupJid=`
`fetch_invite_code`	GET	`/group/inviteCode/{instance}?groupJid=`
`revoke_invite_code`	POST	`/group/revokeInviteCode/{instance}?groupJid=`
`accept_invite`	GET	`/group/acceptInviteCode/{instance}?inviteCode=`
`send_group_invite`	POST	`/group/sendInvite/{instance}`
`update_participants`	POST	`/group/updateParticipant/{instance}?groupJid=`
`update_group_setting`	POST	`/group/updateSetting/{instance}?groupJid=`
`leave_group`	DELETE	`/group/leaveGroup/{instance}?groupJid=`
`find_group_by_invite`	GET	`/group/inviteInfo/{instance}?inviteCode=`
`connection_state`	GET	`/instance/connectionState/{instance}`
`restart_instance`	POST	`/instance/restart/{instance}`
`logout_instance`	DELETE	`/instance/logout/{instance}`
`get_settings`	GET	`/settings/find/{instance}`
`set_settings`	POST	`/settings/set/{instance}`
`find_webhook`	GET	`/webhook/find/{instance}`
`set_webhook`	POST	`/webhook/set/{instance}`
`find_labels`	GET	`/label/findLabels/{instance}`
`handle_label`	POST	`/label/handleLabel/{instance}`

Evolution API v2が必要です。

ライセンス

MIT — LICENSE を参照してください。

免責事項

コミュニティソフトウェアであり、Evolution APIやWhatsAppのいかなる組織とも提携していません。

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

mcp-zap
Communication App Automation
Joaquim-Salles
F
license
Not graded
quality
D
maintenance
MCP server for sending and receiving WhatsApp messages through Evolution API, enabling management of instances, messages, and chats directly from Claude Code.
Updated 3 months ago (2026-05-09 22:12 UTC)
mcp-evolution-api
Communication Customer Support
pauloFroes
F
license
A
quality
D
maintenance
MCP server that wraps the Evolution API (WhatsApp) as semantic tools for LLM agents, enabling messaging, chat management, group operations, and instance control via natural language.
Updated 6 months ago (2026-03-02 17:10 UTC)
32
Evolution MCP Server
Communication Developer Tools
MatheusLarcher
F
license
Not graded
quality
D
maintenance
MCP server for managing WhatsApp instances and sending messages through Evolution API.
Updated 10 months ago (2025-10-08 13:02 UTC)
1
MCP-WHATSAPP-EVO
Communication Social Media
jppeiro90
A
license
C
quality
C
maintenance
Exposes the full WhatsApp API via Evolution API, enabling message sending, chat history, group management, and more through MCP tools.
Updated 2 months ago (2026-06-30 02:47 UTC)
70
MIT

View all related MCP servers

Related MCP Connectors

omnidim-mcp-server
Official MCP server for OmniDimension. Drive voice agents, dispatch calls, and run bulk campaigns.
mcp-aichat
MCP server for AI dialogue using various LLM models via AceDataCloud
vonage-documentation-mcp
MCP server for Vonage API documentation, code snippets, tutorials, and troubleshooting.

View all MCP Connectors

Appeared in Searches

WhatsApp MCP (Model Context Protocol) Integration

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/billyfranklim1/mcp-evolution'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-evolution

アーキテクチャ

ツール

メッセージ

チャット

プロフィール

グループ

インスタンス

Webhook

ラベル

npx経由でのインストールと実行

設定

Claude Desktop / Claude Codeでの使用

開発

ラップされたEvolution APIエンドポイント

ライセンス

免責事項

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

mcp-zap

mcp-evolution-api

Evolution MCP Server

MCP-WHATSAPP-EVO

Related MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API