项目介绍
<p align="center"><img src="https://gips0.baidu.com/it/u=1986588296,2219237882&fm=3081&app=3081&f=PNG?w=1465&h=250" height="70" alt="Twilio Alpha"/><img src="https://gips2.baidu.com/it/u=3664225391,3188433809&fm=3081&app=3081&f=PNG?w=1465&h=250" height="70" alt="Twilio Alpha"/></p>
<h1 align="center">Twilio MCP 单仓库</h1>
这是一个用于暴露所有Twilio API的Model Context Protocol（MCP）服务器的单仓库。
什么是MCP？
Model Context Protocol（MCP）是一种在AI工具和服务之间交换模型上下文信息的协议。此实现允许您将Twilio的API暴露给支持MCP协议的AI助手和其他工具。
包
这个单仓库包含两个主要包：
- mcp - 所有Twilio公共API的MCP服务器
- openapi-mcp-server - 提供给定OpenAPI规范的MCP服务器
每个包都有自己的详细文档：
快速开始
最简单的方法是使用npx：
{
"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规范文件的位置
完整的配置详情，请参阅上面链接的包特定文档。
开发
# 运行测试
npm test
# 运行代码检查
npm run lint
# 修复代码检查问题
npm run lint:fix
常见问题排查
- 上下文大小限制：由于LLM上下文限制，使用
--services或--tags加载特定API - 身份验证问题：验证您的Twilio API凭证格式和权限
- API版本控制：检查您是否使用了正确的API版本（v1、v2、v3）以满足您的需求
详细的故障排除指南，请参阅上面链接的包特定文档。
贡献
欢迎贡献！请随时提交Pull Request。
许可证
本项目采用ISC许可证 - 详情请参阅LICENSE文件。