MCP エボリューション API

WhatsApp 自動化のためのEvolution APIと統合する、Claude 用の Model Context Protocol (MCP) サーバー。

概要

この MCP サーバーにより、Claude は Evolution API を介して WhatsApp と対話できるようになり、次のような機能が有効になります。

WhatsAppインスタンスの管理
さまざまな種類のメッセージを送信する
連絡先とグループの操作
Webhookと設定の構成

Related MCP server: API Tester MCP Server

📂 プロジェクト構造

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コンポーズ	Docker Composeで実行	`git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api` `docker-compose up -d`
ドッカー	コンテナのビルドと実行	`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 構成ファイル (通常は~/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