Twilio MCP Server

官方

与Twilio API交互，发送消息、管理电话号码、配置账户等。

GitHub
107

文档

Twilio AlphaTwilio Alpha

Twilio MCP 单体仓库

这是一个用于模型上下文协议服务器的单体仓库，可对外暴露所有 Twilio API。

什么是 MCP？

模型上下文协议（MCP）是一种用于在 AI 工具和服务之间交换模型上下文信息的协议。此实现允许你将 Twilio 的 API 暴露给 AI 助手及其他支持 MCP 协议的工具。

软件包

此单体仓库包含两个主要软件包：

  • mcp - 面向所有 Twilio 公共 API 的 MCP 服务器
  • openapi-mcp-server - 一个提供指定 OpenAPI 规范的 MCP 服务器

每个软件包都有自己详尽的 README 文档：

快速开始

最简单的入门方式是使用 npx：

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp",
        "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
      ]
    }
  }
}

有关如何查找/创建 API 密钥和密钥的信息，请访问 Twilio 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 上下文限制，请使用 --services 或 --tags 加载特定 API
  • 身份验证问题：验证你的 Twilio API 凭证格式和权限
  • API 版本控制：检查你是否使用了正确的 API 版本（v1、v2、v3）

有关详细的故障排除指导，请参阅特定软件包文档。

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 ISC 许可证 - 详情请参阅 LICENSE 文件。