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
安装
克隆存储库:
git clone <repository-url> cd mcp-server安装依赖项: .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脚本获得。
This server cannot be deployed
Maintenance
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
- FlicenseNot gradedqualityNot gradedmaintenanceA 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-
- AlicenseNot gradedqualityDmaintenanceMCP server for WATI WhatsApp Business API enabling AI assistants to send messages, manage contacts, and handle media.MIT
- AlicenseNot gradedqualityCmaintenanceMCP server that connects AI agents to WhatsApp using the multi-device API, enabling messaging, group management, and more as a regular user.6 npmMIT
- AlicenseAqualityDmaintenanceMCP 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.89 npmMIT