Rootly MCP Server

🚀 Rootly MCP サーバー

Rootly MCP サーバーは、Rootly API 用に作成された MCP サーバーです。Cursor、Windsurf、Claude などの互換性のある MCP エディタに統合することができます。IDE を離れることなく、1 分以内に本番環境の障害を解決できます。

🚀 クイックスタート

🔧 前提条件

• 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 ツールを動的に生成
• コンテキストウィンドウのオーバーフローを防ぐため、デフォルトでページング（1 ページあたり 10 項目）
• AI エージェントに公開する API パスの数を制限

アクセス可能なパスの数を制限する理由は 2 つあります。

• コンテキストサイズ：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 は、システムの信頼性と運用の卓越性の未来を築いています。オープンソースのインキュベーターとして機能し、アイデアを共有し、実験を行い、迅速にプロトタイピングします。研究成果がコミュニティ全体に恩恵をもたらすことを目指しています。