用途
Twilio MCP Monorepo 面向希望在 AI 工具与 Twilio 服务之间建立标准化连接的开发者。它把 Twilio 的公开 API 封装为 Model Context Protocol（MCP）工具，使支持 MCP 协议的 AI 助手和其他工具能够直接调用 Twilio 能力，例如发送消息、管理电话号码、配置账户等。
主要包与能力
该单体仓库包含两个主要包：
- mcp：面向 Twilio 全部公开 API 的 MCP 服务端，将 Twilio API 暴露为 MCP 工具。
- openapi-mcp-server：一个 MCP 服务端，用于提供给定的 OpenAPI 规范，即把 OpenAPI 规范转化为 MCP 工具。
每个包都有各自完整的 README 文档。
使用方式
最简单的起步方式是使用 npx。使用前可参考 Twilio API Keys 文档了解如何查找或创建 API Key 与 Secret。
两个包均接受配置参数：
- MCP Server：使用
--services和--tags过滤要暴露的 API。 - OpenAPI MCP Server：使用
--apiPath指定 OpenAPI 规范文件的位置。
完整配置细节可参考各包专属文档。
安全建议
为防止注入攻击导致不受信任的系统访问 Twilio 数据，ETI 团队建议 Twilio MCP 服务端用户避免将任何社区 MCP 服务端与官方服务端一起安装或运行。这样做有助于确保只有受信任的 MCP 服务端能访问与 Twilio 账户交互的工具，降低未经授权数据访问的风险。
常见问题排查
- 上下文大小限制：受 LLM 上下文限制影响，建议通过
--services或--tags加载特定 API。 - 身份验证问题：检查 Twilio API 凭据格式与权限。
- API 版本：确认使用了符合需求的正确 API 版本（v1、v2、v3）。
详细排查指南见各包专属文档。
其他信息
项目欢迎贡献，可提交 Pull Request。采用 ISC License，详见 LICENSE 文件。
