mcpField
T
Twilio MCP Monorepo

Twilio MCP Monorepo

本地服务
twilioalpha.com通信协作11368 周前更新
代码仓库访问官网

关于 Twilio MCP Monorepo

Twilio MCP Monorepo 将 Twilio 的全部公开 API 作为 MCP 工具暴露给 AI 助手，并包含把 OpenAPI 规范转换为 MCP 工具的生成器。适合希望通过 Agent 操作 Twilio 账户的开发者。

主要功能

  1. 01暴露 Twilio 全部公开 API 为 MCP 工具
  2. 02OpenAPI 转 MCP 工具的生成器
  3. 03通过 --services 与 --tags 筛选 API
  4. 04基于 npx 的快速配置方式

适用场景

  1. 01让 AI 助手通过 Twilio API 发送消息或管理资源
  2. 02按服务或标签加载部分 API 以控制上下文大小
  3. 03为其他 OpenAPI 规范生成 MCP 服务

MCP 相关

该项目提供 MCP 服务，将 Twilio API 操作以 MCP 工具形式暴露给支持 MCP 的 AI 客户端。使用时需提供 Twilio 的 Account SID 与 API 密钥凭据。

#ai#mcp#openapi#twilio-api#openapi3#openapi-generator#twilio-mcp

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "twilio-labs": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp"
      ]
    }
  }
}
启动命令npx -y @twilio-alpha/mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@twilio-alpha/mcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Twilio AlphaTwilio Alpha

Twilio MCP Monorepo

这是一个单体仓库，用于存放可提供所有 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"
      ]
    }
  }
}

请访问 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

常见问题排查

  • 上下文大小限制：由于大模型上下文限制，请使用 --services 或 --tags 加载特定 API
  • 身份验证问题：检查 Twilio API 凭据的格式和权限
  • API 版本：检查是否针对需求使用了正确的 API 版本（v1、v2、v3）

详细的故障排查指南请参阅软件包专属文档。

贡献

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

许可证

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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。