WhatsApp Business API MCP Server
mattcoatsworth
README
WhatsApp Business API MCP 服务器
一个全面的模型上下文协议 (MCP) 服务器,用于与 WhatsApp Business API 交互。
## 功能
- 发送各种类型的消息(文本、模板、媒体、互动消息)
- 管理消息模板
- 上传和管理媒体文件
- 更新商家资料信息
- 管理电话号码
- 配置 Webhook
## 前提条件
- Node.js 16 或更高版本
- WhatsApp Business API 凭据:
- API 令牌
- 电话号码 ID
- 商家帐户 ID
## 安装
```bash
npm install whatsapp-business-mcp-server
```
或者使用 npx 直接运行:
```bash
npx whatsapp-business-mcp-server
```
## 配置
创建一个包含您的 WhatsApp Business API 凭据的 `.env` 文件:
```
WHATSAPP_API_TOKEN=your_api_token_here
WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id_here
WHATSAPP_BUSINESS_ACCOUNT_ID=your_business_account_id_here
WHATSAPP_API_VERSION=v18.0
```
## 用法
### 启动服务器
```bash
npm start
```
### 开发模式
```bash
npm run dev
```
### 与 MCP Inspector 一起使用
```bash
npm run inspect
```
## 可用工具
### 消息
- `sendTextMessage` - 发送文本消息
- `sendTemplateMessage` - 发送模板消息
- `sendImageMessage` - 发送图片
- `sendDocumentMessage` - 发送文档
- `sendVideoMessage` - 发送视频
- `sendLocationMessage` - 发送位置信息
- `sendContactMessage` - 发送联系人信息
- `sendInteractiveMessage` - 发送互动消息
- `markMessageAsRead` - 标记消息为已读
### 媒体
- `uploadMedia` - 将媒体上传到 WhatsApp 服务器
- `getMediaUrl` - 获取媒体文件的 URL
- `deleteMedia` - 从 WhatsApp 服务器删除媒体
### 模板
- `getMessageTemplates` - 获取消息模板
- `createMessageTemplate` - 创建消息模板
### 商家资料
- `getBusinessProfile` - 获取商家资料信息
- `updateBusinessProfile` - 更新商家资料
### 电话号码
- `getPhoneNumbers` - 获取电话号码
- `getPhoneNumberById` - 获取电话号码详细信息
- `requestVerificationCode` - 请求验证码
- `verifyCode` - 验证电话号码
### Webhook
- `getWebhookInfo` - 获取 Webhook 信息
- `subscribeWebhook` - 订阅 Webhook
- `deleteWebhookSubscription` - 删除 Webhook 订阅
## 可用资源
- `whatsapp://templates` - 列出所有模板
- `whatsapp://templates/{category}` - 按类别列出模板
- `whatsapp://template/{name}` - 获取模板详细信息
- `whatsapp://business-profile` - 查看商家资料
- `whatsapp://phone-numbers` - 列出电话号码
- `whatsapp://phone-number/{id}` - 获取电话号码详细信息
- `whatsapp://docs` - API 文档
## 许可证
MIT
推荐服务器
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
MCP Package Docs Server
促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。
Claude Code MCP
一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。
@kazuph/mcp-taskmanager
用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。
mermaid-mcp-server
一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。
Jira-Context-MCP
MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。

Linear MCP Server
一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

Sequential Thinking MCP Server
这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。
Curri MCP Server
通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要,从而实现与 Curri API 的交互。