mcp消息鸟
包装MCP服务器 MessageBird对话API 作为LLM代理的语义工具。发送和接收WhatsApp消息、管理模板和处理联系人。
适用于 克劳德代码, 法典, 克劳德桌面, 光标, VS代码, 帆板运动,以及任何兼容MCP的客户端。
先决条件
- Node.js 18+
- MessageBird API密钥(在这里买一个)
| 变量 | 在哪里可以找到 |
|---|---|
MESSAGEBIRD_API_KEY |
仪表板→ 开发者→ API访问 |
安装
克劳德代码
有三种安装范围可供选择:
| 范围 | 标志 | 配置文件 | 用例 |
|---|---|---|---|
| 本地 | -s local |
.mcp.json |
仅此项目(默认) |
| 项目 | -s project |
.claude/mcp.json |
通过git与团队共享 |
| 用户 | -s user |
~/.claude/mcp.json |
您的所有项目 |
快速设置(内联环境变量):```bash
claude mcp add messagebird -s user \
-e MESSAGEBIRD_API_KEY=your-key \
-- npx -y github:pauloFroes/mcp-messagebird
> 替换 `-s user` 和 `-s local` 或 `-s project` 根据需要。
**持久设置(.env文件):**
添加到您的 `.mcp.json`:```json
{
"messagebird": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-messagebird"],
"env": {
"MESSAGEBIRD_API_KEY": "${MESSAGEBIRD_API_KEY}"
}
}
}
然后在你的 .env 文件:```
MESSAGEBIRD_API_KEY=your-api-key
> 看 `.env.example` 对于所有必需的变量。
### 法典
添加到您的Codex配置中:```toml
[mcp_servers.messagebird]
command = "npx"
args = ["-y", "github:pauloFroes/mcp-messagebird"]
env_vars = ["MESSAGEBIRD_API_KEY"]
克劳德桌面
添加 claude_desktop_config.json:```json
{
"mcpServers": {
"messagebird": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-messagebird"],
"env": {
"MESSAGEBIRD_API_KEY": "your-key"
}
}
}
}
### 光标
添加 `~/.cursor/mcp.json`:```json
{
"mcpServers": {
"messagebird": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-messagebird"],
"env": {
"MESSAGEBIRD_API_KEY": "your-key"
}
}
}
}
VS代码
添加 .vscode/mcp.json 在您的项目中:```json
{
"servers": {
"messagebird": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-messagebird"],
"env": {
"MESSAGEBIRD_API_KEY": "your-key"
}
}
}
}
### 帆板运动
添加 `~/.codeium/windsurf/mcp_config.json`:```json
{
"mcpServers": {
"messagebird": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-messagebird"],
"env": {
"MESSAGEBIRD_API_KEY": "your-key"
}
}
}
}
可用工具
消息传递
| 工具 | 说明 |
|---|---|
send_text |
发送WhatsApp短信 |
send_media |
发送图像、视频、音频或文件 |
send_location |
发送带有坐标的位置 |
send_template |
发送预先批准的模板(HSM)消息 |
send_interactive_buttons |
发送快速回复按钮(最多3个) |
send_interactive_list |
发送可选列表菜单 |
对话
| 工具 | 说明 |
|---|---|
list_conversations |
列出所有对话线索 |
get_conversation |
按ID获取对话详细信息 |
update_conversation |
更新对话状态(活动/存档) |
list_conversation_messages |
列出对话中的消息 |
get_message |
获取特定消息 |
reply_to_conversation |
在现有对话中发送回复 |
list_messages |
列出所有对话中的消息 |
模板
| 工具 | 说明 |
|---|---|
list_templates |
列出所有WhatsApp消息模板 |
get_template |
按名称和语言获取模板详细信息 |
create_template |
为Meta审批创建新模板 |
update_template |
更新现有模板 |
delete_template |
删除模板和所有语言变体 |
delete_template_variant |
删除特定语言变体 |
联系人
| 工具 | 说明 |
|---|---|
list_contacts |
列出所有联系人 |
get_contact |
通过ID、电话或姓名联系 |
create_contact |
创建新联系人 |
update_contact |
更新联系信息 |
delete_contact |
永久删除联系人 |
认证
使用MessageBird API密钥身份验证。密钥通过 Authorization: AccessKey {key} 每个请求的标题。API密钥设置为 MESSAGEBIRD_API_KEY 安装时的环境变量。
许可证
麻省理工学院
