uptrack-mcp

@uptrack-app/mcp

面向 Uptrack 在线状态监控的 MCP 服务。可与 Claude.ai、ChatGPT、Cursor、VS Code、Windsurf 或任何兼容 MCP 的 AI 助手搭配使用。

支持两种传输方式：

• 远程 MCP（推荐） — 使用 https://api.uptrack.app/mcp，搭配 OAuth 2.0 + PKCE。无需粘贴 API 密钥，也无需安装 npm。适用于 Claude.ai、ChatGPT、VS Code（1.100+）、Cursor 和 Windsurf。
• Stdio（本软件包） — 适用于离线 Agent、CI 运行器、Claude Desktop，以及任何无法连接远程 MCP 端点的客户端。

远程 MCP（OAuth）

最快的接入方式。如果你的客户端支持远程 MCP + OAuth，请使用此方式。

客户端	安装
Cursor	添加远程 MCP 服务 → 粘贴 https://api.uptrack.app/mcp
VS Code 1.100+	添加远程 MCP 服务 → 粘贴 https://api.uptrack.app/mcp
Windsurf	添加远程 MCP 服务 → 粘贴 https://api.uptrack.app/mcp
Claude.ai	Settings → Connectors → Add custom connector → 粘贴 https://api.uptrack.app/mcp
ChatGPT	Settings → Connectors → Add remote MCP → 粘贴 https://api.uptrack.app/mcp

OAuth 会在应用内处理授权。无需 API 密钥。你需要拥有 Uptrack 付费套餐账户。

完整安装步骤请参阅 Uptrack MCP 指南。

Stdio（本软件包）

远程 MCP 不可用时，请使用此方式 — 适用于离线环境、CI 或 Claude Desktop。

Claude Code

claude mcp add uptrack -- env UPTRACK_API_KEY=your_key npx -y @uptrack-app/mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "uptrack": {
      "command": "npx",
      "args": ["-y", "@uptrack-app/mcp"],
      "env": {
        "UPTRACK_API_KEY": "uk_live_..."
      }
    }
  }
}

Cursor / Windsurf

在 MCP 设置中添加与 Claude Desktop 相同的 stdio 配置。

可用工具

工具	描述
list_monitors	列出所有监控项，包括状态、URL、间隔和在线时间
get_monitor	获取指定监控项的详细信息
create_monitor	创建新的监控项（HTTP、TCP、DNS、SSL、心跳）
update_monitor	更新监控项配置
pause_monitor	暂停正在运行的监控项
resume_monitor	恢复已暂停的监控项
delete_monitor	删除监控项
list_incidents	列出近期事件
get_incident	获取单个事件
acknowledge_incident	确认尚未处理的事件

使用示例

连接后，可以向 AI 助手提问：

• “列出我的监控项”
• “为 https://example.com 创建一个每 30 秒检查一次的监控项”
• “现在是否有服务宕机？”
• “显示近期事件”
• “确认 API 监控项上的事件”

身份验证

• 远程 MCP：OAuth 2.0 — 无需 API 密钥，授权在应用内处理。
• Stdio：在控制面板的 Settings → API Keys 下创建 API 密钥。请参阅如何使用 API 密钥。API 密钥需要付费套餐。

链接

• Uptrack — 在线状态监控，每 30 秒检查一次，并提供免费套餐
• MCP 指南 — 如何连接客户端
• OpenAPI 规范
• MCP 协议

许可证

MIT