<p align="center"><img src="https://github.com/twilio-labs/mcp/blob/246f1b1cd1854d1343468af07a2dfa179dc30a16/docs/twilioAlphaLogoLight.png?raw=true#gh-dark-mode-only" height="70" alt="Twilio Alpha"/><img src="https://github.com/twilio-labs/mcp/blob/246f1b1cd1854d1343468af07a2dfa179dc30a16/docs/twilioAlphaLogoDark.png?raw=true#gh-light-mode-only" height="70" alt="Twilio Alpha"/></p> <h1 align="center">Twilio MCP 单仓库</h1>

这是一个用于暴露所有 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 文档，其中包含详细文档：

• MCP 包文档
• OpenAPI MCP 服务器文档

快速开始

最简单的开始方法是使用 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 文件。