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 | 您的所有项目 |
快速设置(内联环境变量):
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:
{
"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配置中:
[mcp_servers.messagebird]
command = "npx"
args = ["-y", "github:pauloFroes/mcp-messagebird"]
env_vars = ["MESSAGEBIRD_API_KEY"]克劳德桌面
添加 claude_desktop_config.json:
{
"mcpServers": {
"messagebird": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-messagebird"],
"env": {
"MESSAGEBIRD_API_KEY": "your-key"
}
}
}
}光标
添加 ~/.cursor/mcp.json:
{
"mcpServers": {
"messagebird": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-messagebird"],
"env": {
"MESSAGEBIRD_API_KEY": "your-key"
}
}
}
}VS代码
添加 .vscode/mcp.json 在您的项目中:
{
"servers": {
"messagebird": {
"command": "npx",
"args": ["-y", "github:pauloFroes/mcp-messagebird"],
"env": {
"MESSAGEBIRD_API_KEY": "your-key"
}
}
}
}帆板运动
添加 ~/.codeium/windsurf/mcp_config.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 安装时的环境变量。
许可证
麻省理工学院
