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 令牌](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 個項目），有效防止上下文窗口溢出。
• API 路徑訪問限制：限制暴露給 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 正在構建系統可靠性和運營卓越性的未來。我們作為開源孵化器運作，分享想法、進行實驗並快速原型化。我們致力於確保我們的研究惠及整個社區。