Rootly AI Labs Rootly MCP Server

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

インストール方法

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