Twilio Messaging MCP Server

Twilio Messaging MCP 服务

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

功能

• 通过 Twilio 发送 SMS 消息
• 通过 @deshartman/mcp-status-callback 增强处理来自 Twilio 的状态回调
• 通过模型上下文协议（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 直接执行此软件包：

# Run with required parameters
npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

# With environment variables for 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 域名（可选）

用法

运行服务

你可以使用提供的脚本和 .env 文件运行服务：

# Create a .env file with your credentials
# See .env.example for the required format

# Run the server (no arguments needed)
./run-server.sh

.env 文件应包含：

ACCOUNT_SID=YOUR_ACCOUNT_SID
API_KEY=YOUR_API_KEY
API_SECRET=YOUR_API_SECRET
TWILIO_NUMBER=YOUR_TWILIO_PHONE_NUMBER
NGROK_AUTH_TOKEN=YOUR_NGROK_AUTH_TOKEN
NGROK_CUSTOM_DOMAIN=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