API协议服务器

Twilio MCP Monorepo是一个用于暴露Twilio API的模型上下文协议服务器,支持AI工具和服务之间的模型上下文信息交换。

  • by twilio-labs
  • TypeScript
  • 本地部署
  • 113 星标
  • 更新于
在 GitHub 查看 twilio-labs/mcp

使用说明

Twilio MCP Monorepo

这是一个用于模型上下文协议服务器的monorepo,它公开了所有Twilio API。

什么是MCP?

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

包裹

这个monorepo包含两个主要包:

每个软件包都有自己的全面自述文件,其中包含详细的文档:

快速开始

最简单的入门方法是使用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许可证获得许可-有关详细信息,请参阅许可证文件。