AI导哈

Twilio监控MCP服务器

一个封装Twilio Monitor API的MCP服务器，允许从Claude Code和其他MCP客户端直接检索Twilio警报和事件。

  • by geekfeedjapan
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 geekfeedjapan/mcp-twilio-monitor

使用说明

Twilio Monitor MCP 服务器

英语 | 日语

一个MCP（模型上下文协议）服务器，它封装了Twilio Monitor API，使您能够直接从Claude Code和其他MCP客户端检索Twilio警报和事件。

快速入门

立即使用 npx 开始（无需安装）：

npx @geekfeed/mcp-twilio-monitor

特点/特性

  • ✅ 列出并检索Twilio Monitor警报
  • ✅ 列出并检索Twilio Monitor事件
  • ✅ 按日期范围、日志级别和其他标准进行筛选
  • ✅ 与Claude Code及其他MCP客户端兼容
  • ✅ 使用npx实现零安装

设置

获取您的Twilio凭据

在设置之前，请从（某处）获取您的凭据 Twilio 控制台：

  1. 找到你的 账户SID（Service Identification，服务标识） 并且 认证令牌 在仪表盘上
  2. 在以下配置中使用这些值

配置（适用于所有MCP客户端）

这台服务器与任何兼容MCP的客户端都能配合工作，包括 克劳德·科德， Claude Desktop（可译为“Claude桌面版”或保持原样，若“Desktop”在此处特指某种软件或平台的桌面版本，则可根据具体语境灵活翻译）， 克莱恩（Cline，此为人名或地名的音译，具体含义需根据上下文确定）， 继续，以及其他。

Claude Code的示例配置 (.mcp.json):

{
  "mcpServers": {
    "twilio-monitor": {
      "command": "npx",
      "args": ["@geekfeed/mcp-twilio-monitor"],
      "env": {
        "TWILIO_ACCOUNT_SID": "your_account_sid",
        "TWILIO_AUTH_TOKEN": "your_auth_token"
      }
    }
  }
}

对于其他MCP客户端，使用相同的配置结构。常见的配置文件位置：

  • 克劳德桌面版 (macOS): （注：macOS是苹果公司开发的操作系统，可直接译为“苹果操作系统”或保持原样，因为“macOS”在中文语境中已被广泛接受。） ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Desktop（可译为“Claude桌面版”） (Windows)： %APPDATA%\Claude\claude_desktop_config.json
  • **克莱恩（Cline，根据音译，具体翻译可能因语境而异）**VS Code 设置 → “Cline: MCP 设置”
  • 继续继续设置 → experimental.modelContextProtocolServers

替代安装方法

如果你更倾向于安装包而不是使用 npx：

# Local installation
npm install @geekfeed/mcp-twilio-monitor

# Global installation
npm install -g @geekfeed/mcp-twilio-monitor

然后使用 node /path/to/node_modules/@geekfeed/mcp-twilio-monitor/dist/index.js 或者只是 mcp-twilio-monitor （如果已全局安装）则作为命令使用。

可用工具

1. 列出警报

列出Twilio在检测到您的账户存在问题时生成的警报。

参数：

  • limit (数字，可选)：要返回的最大警报数量（默认：20，最大：1000）
  • logLevel (字符串，可选)：按日志级别过滤： error， warning， notice或者 debug
  • startDate (字符串，可选)：过滤在此日期或之后创建的警报（ISO 8601格式：YYYY-MM-DD）
  • endDate (字符串，可选)：过滤在此日期或之前创建的警报（ISO 8601 格式：YYYY-MM-DD）

2. 获取警报

通过SID获取特定警报的详细信息。

参数：

  • alertSid (字符串，必需): 要检索的警报的SID

3. 列出事件（或：事件列表）

列出代表您Twilio账户中重要事件的列表。

参数：

  • limit (数字，可选)：要返回的最大事件数（默认：20，最大：1000）
  • actorSid （字符串，可选）：通过导致事件发生的操作者的SID进行过滤
  • eventType （字符串，可选）：按事件类型过滤（例如，'account.updated'，'call.created'）
  • resourceSid （字符串，可选）：通过受影响资源的SID进行过滤
  • sourceIpAddress （字符串，可选）：按源IP地址过滤
  • startDate (字符串，可选)：过滤在此日期或之后创建的事件（ISO 8601格式：YYYY-MM-DD）
  • endDate （字符串，可选）：过滤在此日期或之前创建的事件（ISO 8601 格式：YYYY-MM-DD）

4. 获取事件

通过SID获取特定事件的详细信息。

参数：

  • eventSid （字符串，必填）：要检索的事件的安全标识符（SID）

使用示例

一旦在Claude Code中进行配置，您就可以使用自然语言与您的Twilio Monitor数据进行交互：

Show me the latest error alerts from the last 10 calls

Get all events that occurred today

Show details for alert NO12345678901234567890123456789012

故障排除

认证错误

  • 验证是否 TWILIO_ACCOUNT_SID 并且 TWILIO_AUTH_TOKEN 设置正确
  • 检查你在（某处/某系统中的）凭证 Twilio 控制台
  • 确保你的凭证中没有多余的空格或引号

连接错误

要求

  • Node.js 14 或更高版本
  • Twilio账户，具备Monitor API访问权限

作者

根据提供的信息，原文内容“Shinji Uchi / GeekFeed Co.,Ltd.”翻译成中文为：“内田伸司 / GeekFeed有限公司”。

  • 网站：https://www.geekfeed.co.jp

许可证

麻省理工学院（MIT）

相关 MCP