使用说明
Twilio MCP Monorepo
这是一个用于模型上下文协议服务器的monorepo,它公开了所有Twilio API。
什么是MCP?
模型上下文协议(MCP)是一种用于在AI工具和服务之间交换模型上下文信息的协议。此实现允许您将Twilio的API暴露给AI助手和支持MCP协议的其他工具。
包裹
这个monorepo包含两个主要包:
- 主控程序 -Twilio所有公共API的MCP服务器
- openapi mcp服务器 -服务于给定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规范文件的位置
有关完整的配置详细信息,请参阅上面链接的特定于软件包的文档。
发展
# Run tests
npm test
# Run linting
npm run lint
# Fix linting issues
npm run lint:fix
常见问题排查
- 上下文大小限制:由于LLM上下文限制,请使用以下方式加载特定API
--services或--tags - 身份验证问题:验证您的Twilio API凭据格式和权限
- API版本:检查您是否根据需要使用了正确的API版本(v1、v2、v3)
有关详细的故障排除指南,请参阅特定于软件包的文档。
贡献
欢迎投稿!请随时提交拉取请求。
许可证
此项目根据ISC许可证获得许可-有关详细信息,请参阅许可证文件。