内容
# whapi-mcp
Whapi Cloud(WhatsApp API)的模型上下文协议(MCP)服务器。
## 快速开始
需要 Node.js 18+。
通过 NPX 安装并运行:
```bash
npx -y whapi-mcp@latest
```
或者设置您的 Whapi API 令牌并运行:
```bash
# PowerShell
$env:API_TOKEN="YOUR_TOKEN"; npx -y whapi-mcp@latest
```
## 与 MCP 客户端一起使用
- Cursor: 添加到 %USERPROFILE%\.cursor\mcp.json
```json
{
"mcpServers": {
"whapi-mcp": {
"command": "npx",
"args": ["-y", "whapi-mcp@latest"],
"env": { "API_TOKEN": "YOUR_TOKEN" }
}
}
}
```
- Claude Desktop: 添加到 %APPDATA%\Claude\claude_desktop_config.json(与上述结构相同)。
## 工具
服务器公开了从 Whapi OpenAPI 生成的工具。示例:
- sendMessageText(必填:to, body)
示例调用(伪):
```
name: sendMessageText
arguments: { "to": "1234567890@s.whatsapp.net", "body": "Hello" }
```
## 代理技能
**Whapi 代理技能** — 为 AI 代理提供结构化指南现已可用。安装它可以为您的代理提供准确的聊天 ID 格式、MCP 设置、Webhook 配置、消息类型和安全广播模式的知识 — 在错误发生之前防止最常见的错误。
```bash
npx skills add Whapi-Cloud/whapi-agent-skills
```
## 许可证
MIT