Twilio Messaging MCP Server
2025.04.08
2
TypeScript短信服务AI集成交流协作
Twilio Messaging MCP Server 是一个基于 Twilio API 的短信发送服务，通过 Model Context Protocol (MCP) 与 Claude AI 集成，提供短信发送、状态回调处理等功能。该服务支持通过 npm 安装或直接使用 npx 运行，适合需要快速集成短信功能的开发场景。
View on GitHub
Overview
基本能力
产品定位
Twilio Messaging MCP Server 是一个专为开发者设计的短信发送服务，通过 Twilio API 提供高效的短信发送能力，并支持与 AI 集成。
核心功能
- 通过 Twilio API 发送短信
- 支持 Twilio 状态回调，并通过
@deshartman/mcp-status-callback增强处理 - 与 Claude AI 通过 Model Context Protocol (MCP) 集成
- 支持通过 npx 直接运行，无需安装
适用场景
- 需要快速集成短信发送功能的开发项目
- 需要与 AI 集成的短信服务
- 需要处理 Twilio 状态回调的应用
工具列表
send-sms: 通过 Twilio 发送短信，并验证服务器准备状态twilio://statuscallback: 获取 Twilio 的最后原始状态回调数据，支持增强的错误处理SendSMS: 用于通过 Twilio Messaging MCP Server 发送短信的提示
常见问题解答
- ngrok 隧道问题: 如果遇到隧道启动失败，可以停止现有端点、使用不同的域名或启用
--pooling-enabled进行负载均衡 - ENOTEMPTY 错误: 如果 npm 安装失败，可以尝试直接使用 Node.js 运行服务器
使用教程
使用依赖
- Node.js >= 18.0.0
- Twilio 账户，包含 Account SID、API Key 和 Secret、Twilio 电话号码
- ngrok 账户，包含 Auth token 和自定义域名（可选）
安装教程
npm install @deshartman/twilio-messaging-mcp-server
或直接使用 npx 运行：
npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>
调试方式
使用 .env 文件运行服务器：
./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>