mcp-evolution-api

@codespar/mcp-evolution-api

Evolution API 用 MCP サーバー — セルフホスト型の WhatsApp メッセージング API

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.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

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

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.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"
      }
    }
  }
}

ツール（25）

ツール	用途
send_text	WhatsApp 経由でテキストメッセージを送信します
send_image	WhatsApp 経由で画像メッセージを送信します
send_document	WhatsApp 経由でドキュメントを送信します
get_instances	すべての WhatsApp インスタンスを一覧表示します
create_instance	新しい WhatsApp インスタンスを作成します
get_qrcode	インスタンスのペアリング用 QR コードを取得します
get_contacts	インスタンスの連絡先を取得します
send_poll	WhatsApp 経由で投票メッセージを送信します
get_messages	チャットのメッセージを取得します
check_number	電話番号が WhatsApp に登録されているか確認します
create_group	WhatsApp グループを作成します
get_group_info	グループのメタデータ、参加者、設定を取得します
update_profile	インスタンスのプロフィール（名前、ステータステキスト、または画像）を更新します
set_presence	インスタンスのオンライン／オフライン状態を設定します
get_chat_history	ページネーションに対応したチャット履歴全体を取得します
logout_instance	インスタンスからログアウトします（インスタンスを削除せずに WhatsApp セッションを切断します）
restart_instance	インスタンスを再起動します
delete_instance	インスタンスを完全に削除します
connection_state	インスタンスの接続状態（open、connecting、close）を取得します
leave_group	WhatsApp グループから退出します
update_group_participants	WhatsApp グループの参加者を追加、削除、昇格、または降格します
fetch_group_invite_code	WhatsApp グループの招待コード／リンクを取得します
mark_message_as_read	チャット内の 1 件以上のメッセージを既読にします
archive_chat	チャットをアーカイブ、またはアーカイブ解除します
delete_message	チャットのメッセージを自分または全員から削除します

認証

Evolution API は、apikey ヘッダーで渡される API キーを使用します。

サンドボックス／テスト

Evolution API はセルフホスト型です。テストには Docker を使用して独自のインスタンスをデプロイしてください。

認証情報の取得

1. Evolution API ドキュメントにアクセスします
2. 独自のインスタンスをデプロイします（Docker を推奨）
3. インスタンスの設定から API キーを取得します
4. 環境変数を設定します

環境変数

変数	必須	説明
EVOLUTION_API_URL	はい	Evolution API インスタンスのベース URL
EVOLUTION_API_KEY	はい	認証用 API キー

ロードマップ

v0.2（予定）

• create_group — WhatsApp グループを作成します
• get_group_info — グループの詳細と参加者を取得します
• update_profile — インスタンスのプロフィール（名前、写真、ステータス）を更新します
• set_presence — オンライン／オフライン状態を設定します
• get_chat_history — 連絡先とのチャット履歴全体を取得します

v0.3（予定）

• bulk_send — 複数の連絡先にメッセージを送信します
• template_messages — WhatsApp Business のテンプレートメッセージを送信します
• label_management — チャットのラベルを作成、更新、割り当てます

貢献をご希望ですか？ PR を作成するか、ツールをリクエストしてください。

リンク

• Evolution API ドキュメント
• Evolution API GitHub
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT