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 控制台：
- 找到你的 账户SID（Service Identification，服务标识） 并且 认证令牌 在仪表盘上
- 在以下配置中使用这些值
配置（适用于所有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或者debugstartDate(字符串，可选)：过滤在此日期或之后创建的警报（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 callsGet all events that occurred todayShow details for alert NO12345678901234567890123456789012故障排除
认证错误
- 验证是否
TWILIO_ACCOUNT_SID并且TWILIO_AUTH_TOKEN设置正确 - 检查你在（某处/某系统中的）凭证 Twilio 控制台
- 确保你的凭证中没有多余的空格或引号
连接错误
- 检查您的网络连接
- 验证Twilio API状态于 status.twilio.com（可译为“Twilio状态页面”，但通常直接保留原网址形式，因为网址本身即为明确标识）
- 确保您的防火墙允许出站连接到Twilio的API
要求
- Node.js 14 或更高版本
- Twilio账户，具备Monitor API访问权限
作者
根据提供的信息，原文内容“Shinji Uchi / GeekFeed Co.,Ltd.”翻译成中文为：“内田伸司 / GeekFeed有限公司”。
- 网站：https://www.geekfeed.co.jp
许可证
麻省理工学院（MIT）