Skip to main content
Glama

MCP エボリューション API

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

概要

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

  • WhatsAppインスタンスの管理

  • さまざまな種類のメッセージを送信する

  • 連絡先とグループの操作

  • Webhookと設定の構成

Related MCP server: Evolution API 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

詳細については、 Evolution API ドキュメントを参照してください。

Available Tools

1 tool
hello_toolD

Hello tool

Inputs: name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.2/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to compare it against. The single tool's purpose is inherently distinct by default.

    Naming Consistency5/5

    A single tool cannot demonstrate inconsistency, as there are no other tool names to compare it to. The naming pattern for 'hello_tool' (snake_case) is consistent within the set, albeit trivially so.

    Tool Count2/5

    A single tool is generally too few for most server purposes, as it limits functionality and suggests an incomplete or trivial implementation. While it might be appropriate for a minimal 'hello world' server, it is inadequate for any substantive domain coverage.

    Completeness1/5

    With only one tool named 'hello_tool', it is impossible to infer a meaningful domain or assess coverage. There are obvious gaps, as no CRUD operations, lifecycle management, or typical API interactions are present, making the surface severely incomplete for any practical purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      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.
      7
      76
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables interaction with WhatsApp through local stdio or remote HTTP/SSE connections. It allows users to send messages, manage groups, and access chat history using natural language.
      3
      -
    • 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.
      -