Skip to main content
Glama
ag2-mcp-servers

WhatsApp Business API MCP Server

MCP 服务器

该项目是针对给定 OpenAPI URL 的 MCP(多代理对话协议)服务器 - https://api.apis.guru/v2/specs/whatsapp.local/1.0/openapi.json ,使用 AG2 的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进行 linting 和格式化,使用mypy进行静态类型检查,使用pytest进行测试。

代码检查和格式化

要检查 linting 问题:

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