Rootly MCP 服务器

为 Rootly API 设计的一个 MCP 服务器，您可以将其集成到您最喜欢的 MCP 兼容编辑器中，例如 Cursor、Windsurf 和 Claude。在不到一分钟的时间内解决生产事故，而无需离开您的 IDE。

先决条件

• Python 3.12 或更高版本
• uv 包管理器

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

• Rootly API 令牌

在您的 IDE 中运行它

通过我们的 PyPi 包 或克隆此仓库来安装。

要在您最喜欢的 MCP 兼容编辑器（我们已测试过 Cursor 和 Windsurf）中设置，请使用以下配置：

{
  "mcpServers": {
    "rootly": {
      "command": "uvx",
      "args": [
        "--from",
        "rootly-mcp-server",
        "rootly-mcp-server"
      ],
      "env": {
        "ROOTLY_API_TOKEN": "<YOUR_ROOTLY_API_TOKEN>"
      }
    }
  }
}

如果您想自定义 allowed_paths 以访问更多 Rootly API 路径，则克隆该包并使用此配置。

{
    "mcpServers": {
      "rootly": {
        "command": "uv",
        "args": [
          "run",
          "--directory",
          "/path/to/rootly-mcp-server",
          "rootly-mcp-server"
        ],
        "env": {
          "ROOTLY_API_TOKEN": "<YOUR_ROOTLY_API_TOKEN>"
        }
      }
    }
  }

功能

此服务器基于 Rootly 的 OpenAPI（Swagger）规范动态生成 MCP 资源：

• 根据 Rootly 的 OpenAPI 规范动态生成 MCP 工具
• 默认分页（10 个项目）以防止上下文窗口溢出
• 限制暴露给 AI 代理的 API 路径数量

我们限制了可访问的路径数量，出于以下原因：

• 上下文大小：因为 Rootly 的 API 中包含大量路径，AI 代理可能会过载并无法正确执行简单操作。目前，我们仅开放 /incidents 和 /incidents/{incident_id}/alerts 路径。
• 安全性：如果您希望限制用户通过 MCP 服务器访问的信息类型或操作

如果需要启用更多路径，请编辑 src/rootly_mcp_server/server.py 中的 allowed_paths 变量。

免责声明

该项目是一个原型，不适用于生产环境。如果您有任何功能建议或发现了一些问题，请随意提交 PR 或打开 Issue。

关于 Rootly AI 实验室

该项目由 Rootly AI Labs 开发。AI 实验室正在构建系统可靠性和运营卓越性的未来。我们作为开源孵化器运作，分享想法、进行实验并快速原型设计。我们致力于确保我们的研究惠及整个社区。