Rootly

🚀 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トークン

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 パスの数を制限

アクセス可能なパスの数を制限する理由は以下の通りです。

• コンテキストサイズ：Rootly の API には多数のパスが含まれているため、AI エージェントがオーバーロードして簡単な操作が正常に実行できなくなる可能性があります。現在、/incidents と /incidents/{incident_id}/alerts のパスのみを公開しています。
• セキュリティ：MCP サーバーを通じてユーザーがアクセスできる情報の種類や操作を制限したい場合

より多くのパスを使用可能にするには、src/rootly_mcp_server/server.py の allowed_paths 変数を編集してください。

📄 免責事項

このプロジェクトはプロトタイプであり、本番環境での使用には適していません。機能提案や問題が見つかった場合は、PR を提出するか、イシューを作成してください。

📚 ドキュメント

このプロジェクトは Rootly AI Labs によって開発されています。AI ラボは、システムの信頼性と運用の卓越性の未来を築いています。オープンソースのインキュベーターとして機能し、アイデアを共有し、実験を行い、迅速にプロトタイピングします。研究成果がコミュニティ全体に恩恵をもたらすことを目指しています。