Rootly MCP 服务器

一个为 Rootly API 创建的 MCP 服务器，您可以将其集成到 Cursor、Windsurf 和 Claude 等兼容的 MCP 编辑器中。在不离开 IDE 的情况下，在不到一分钟的时间内解决生产故障。

先决条件

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

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

• [Rootly API 令牌](https://docs.rootly.com/api-reference/overview#如何生成一个 API 密钥%3F)

在 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 或打开问题。

关于 Rootly AI 实验室

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