Skip to main content
Glama
ag2-mcp-servers

WhatsApp Business API MCP Server

MCPサーバー

このプロジェクトは、AG2 のMCP ビルダーを使用して自動生成された、指定された OpenAPI URL - https://api.apis.guru/v2/specs/whatsapp.local/1.0/openapi.json用の MCP (マルチエージェント会話プロトコル) サーバーです。

前提条件

  • Python 3.9以上

  • pipとuv

Related MCP server: wati-mcp-server

インストール

  1. リポジトリをクローンします。

    git clone <repository-url>
    cd mcp-server
  2. 依存関係のインストール: .devcontainer/setup.shスクリプトはpip install -e ".[dev]"を使用して依存関係のインストールを処理します。dev コンテナを使用していない場合は、このコマンドを手動で実行できます。

    pip install -e ".[dev]"

    あるいは、 uvを使用することもできます。

    uv pip install --editable ".[dev]"

発達

このプロジェクトでは、リンティングとフォーマットにruffを使用し、静的型チェックにmypy使用し、テストにpytest使用します。

リンティングとフォーマット

リンティングの問題を確認するには:

ruff check

コードをフォーマットするには:

ruff format

これらのコマンドは、scripts/lint.shスクリプト経由でも利用できます。

静的分析

静的分析を実行するには (mypy、bandit、semgrep):

./scripts/static-analysis.sh

このスクリプトは、 .pre-commit-config.yamlでコミット前フックとしても構成されます。

テストの実行

カバレッジ付きテストを実行するには:

./scripts/test.sh

pytest が実行され、カバレッジレポートが生成されます。レポートとクリーンアップを組み合わせたものを作成するには、以下を使用します。

./scripts/test-cov.sh

コミット前フック

このプロジェクトでは、 .pre-commit-config.yamlで定義されたコミット前フックを使用します。フックをインストールするには、以下の手順に従います。

pre-commit install

フックは各コミットの前に自動的に実行されます。

サーバーの実行

MCPサーバーは、mcp_server/main.pyスクリプトを使用して起動できます。様々なトランスポートモード(例: stdio 、 sse )をサポートしています。

サーバーを起動するには(例:stdio モード):

python mcp_server/main.py stdio

サーバーは環境変数を使用して設定できます。

  • CONFIG_PATH : JSON 構成ファイルへのパス (例: mcp_server/mcp_config.json )。

  • CONFIG : 構成を含む JSON 文字列。

  • SECURITY : セキュリティ パラメータ (API キーなど) の環境変数。

これらがどのようにロードされるかの詳細については、 mcp_server/main.pyのif __name__ == "__main__":ブロックを参照してください。

tests/test_mcp_server.pyファイルは、テストのためにプログラムでサーバーを起動して操作する方法を示しています。

建築と出版

このプロジェクトは、ビルドと公開にHatchを使用しています。プロジェクトをビルドするには:

hatch build

プロジェクトを公開するには:

hatch publish

これらのコマンドは、scripts/publish.shスクリプト経由でも利用できます。

Related MCP Connectors

  • WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.

  • Unified messaging MCP server: WhatsApp, Instagram, Telegram, SMS, Messenger & email support inbox

  • WhatsApp (Web + Business API), SMS, contacts, and call records via 2Chat's MCP server.

  • Atendio is a WhatsApp AI assistant for businesses in Latin America, on the official WhatsApp Business Platform. This MCP server lets Claude (or any MCP client) list and read WhatsApp conversations, view analytics and assistant settings, and create, edit or delete the rules your AI assistant follows. Remote, OAuth 2.1; the business always reviews and publishes rule changes.

Related MCP Servers

  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    A self-hosted MCP server that connects AI clients to WhatsApp via the WAHA HTTP API. It enables users to manage sessions, search contacts, and send or receive messages and media directly through natural language interfaces.
    6 npm
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server that connects AI agents to WhatsApp using the multi-device API, enabling messaging, group management, and more as a regular user.
    6 npm
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    MCP server for the WhatsApp Business API that enables managing business accounts, phone numbers, message templates, sending template messages, and tracking message status via the Meta Graph API.
    8
    9 npm
    MIT