315 查看 · 2026-07-07 更新


Twilio MCP 单仓库
这是一个用于暴露所有 Twilio API 的 Model Context Protocol 服务器的单仓库。
什么是 MCP?
Model Context Protocol (MCP) 是一种在 AI 工具和服务之间交换模型上下文信息的协议。此实现允许您将 Twilio 的 API 暴露给支持 MCP 协议的 AI 助手和其他工具。
包
该单仓库包含两个主要包:
- mcp - 针对 Twilio 所有公共 API 的 MCP 服务器
- openapi-mcp-server - 一个提供给定 OpenAPI 规范的 MCP 服务器
每个包都有其自己的全面 README 文档,其中包含详细文档:
快速开始
最简单的开始方法是使用 npx:
json { "mcpServers": { "twilio": { "command": "npx", "args": [ "-y", "@twilio-alpha/mcp", "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET" ] } } }
访问 Twilio API 密钥文档 以获取有关如何查找/创建您的 API 密钥和密钥的信息。
安全建议
为了防止注入攻击,这些攻击可能允许不受信任的系统访问您的 Twilio 数据,ETI 团队建议 Twilio MCP 服务器用户避免安装或运行任何社区 MCP 服务器与我们的官方服务器并行。这样做有助于确保只有受信任的 MCP 服务器可以访问与您的 Twilio 账户交互的工具,从而降低未经授权的数据访问风险。
基本配置选项
这两个包都接受配置参数。以下是一个简要概述:
- MCP 服务器:使用
--services和--tags来过滤要暴露的 API - OpenAPI MCP 服务器:使用
--apiPath指定 OpenAPI 规范文件的位置
有关完整的配置详情,请参阅上述特定于包的文档。
开发
bash
运行测试
npm test
运行代码检查
npm run lint
修复代码检查问题
npm run lint:fix
常见问题排查
- 上下文大小限制:由于 LLM 上下文限制,使用
--services或--tags加载特定 API - 身份验证问题:验证您的 Twilio API 凭证格式和权限
- API 版本控制:检查您是否使用了适合需求的正确 API 版本(v1, v2, v3)
有关详细的故障排除指南,请参阅特定于包的文档。
贡献
欢迎贡献!请随时提交 Pull Request。
许可证
该项目根据 ISC 许可证许可 - 详情请参阅 LICENSE 文件。
服务配置
[{'mcpServers': {'twilio': {'args': ['-y', '@twilio-alpha/mcp', 'YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET'], 'command': 'npx'}}}]
来源
- 来源:github
- 链接:https://github.com/twilio-labs/mcp