Rootly-AI-Labs_Rootly-MCP-server

🚀 Rootly MCP 服务器

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 令牌

💻 在您的 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 实验室正在构建系统可靠性和运营卓越性的未来。我们作为开源孵化器运作，分享想法、进行实验并快速原型设计。我们致力于确保我们的研究惠及整个社区。