Twilio Messaging MCP 服务器

一个用于通过 Twilio API 发送 SMS 消息的 MCP 服务器。此服务器提供用于与 Twilio Messaging API 交互的工具、资源和提示。

功能

• 通过 Twilio 发送 SMS 消息
• 从 Twilio 获取状态回调，并通过 @deshartman/mcp-status-callback 进行增强处理
• 通过模型上下文协议 (MCP) 与 Claude AI 集成
• 可通过 npx 执行，无需安装即可轻松使用

前提条件

• Node.js >= 18.0.0
• 具有以下信息的 Twilio 帐户：
  • 帐户 SID
  • API 密钥和密钥
  • Twilio 电话号码
• 具有以下信息的 ngrok 帐户：
  • 身份验证令牌
  • 自定义域名（可选）

安装

npm install @deshartman/twilio-messaging-mcp-server

或直接使用 npx 运行：

npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

NPX 用法

该软件包可以直接使用 npx 执行，无需安装：

# 使用必需的参数运行
npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

# 使用 ngrok 的环境变量
env NGROK_AUTH_TOKEN=your_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

这是可能的，因为该软件包在 package.json 中包含 "bin" 字段，使其可以通过 npx 执行。

环境变量

• NGROK_AUTH_TOKEN: 您的 ngrok 身份验证令牌（回调处理必需）
• NGROK_CUSTOM_DOMAIN: 您的自定义 ngrok 域名（可选）

用法

运行服务器

您可以使用提供的脚本运行服务器：

# 设置您的 ngrok 身份验证令牌
export NGROK_AUTH_TOKEN=your_ngrok_auth_token

# 运行服务器
./run-server.sh <accountSid> <apiKey> <apiSecret> <number> [ngrokDomain]

示例：

./run-server.sh YOUR_ACCOUNT_SID YOUR_API_KEY YOUR_API_SECRET YOUR_TWILIO_PHONE_NUMBER your-domain.ngrok.dev

直接使用 Node.js

env NGROK_AUTH_TOKEN=your_ngrok_auth_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev node build/index.js <accountSid> <apiKey> <apiSecret> <number>

MCP 集成

此服务器提供以下 MCP 功能：

工具

• send-sms: 通过 Twilio 发送 SMS 消息，并进行服务器就绪验证

资源

• twilio://statuscallback: 从 Twilio 获取最新的原始状态回调数据，并进行增强的错误处理

提示

• SendSMS: 使用 Twilio Messaging MCP 服务器发送 SMS 的提示

故障排除

ngrok 隧道问题

如果您遇到类似以下错误：

failed to start tunnel: The endpoint 'https://your-domain.ngrok.dev' is already online.

您有以下几个选择：

1. 首先停止您现有的端点
2. 使用不同的域名
3. 使用 --pooling-enabled 启动两个端点，以在它们之间进行负载均衡

ENOTEMPTY 错误

如果您遇到类似以下的 npm 错误：

npm ERR! code ENOTEMPTY
npm ERR! syscall rename

尝试直接使用 Node.js 运行服务器，而不是使用 npx。

许可证

MIT