oncall-router-mcp

インシデントの最初の10分を奪ってしまう三つの質問に答えるMCPサーバーです。これは誰の所有物か、誰をいつまでに起床か、runbookにはまず何を試すと書いてるのか。それに加えて、多くのツールが間違える四つ目の質問、いまの時計でどの位置にいるべきかという問いにも答えします。この問いは、誰かがチケットを開いた時からではなく、影響が始った時から計測します。

It has no runtime dependencies, no API key, no network call, no attempt to shadow. ローカルの一つのファイルを読むだけ。pytest requests was just to run the gates.

なぜ存在るのか

エスカレーションの知識は三つの場所に散らばている。誰がも更新していないwiki、現在のシフトしか知らないローテーション・ツール、そして、今の所で一番長くいる人の頭の中。午前2時になると、高いコストがのかかる数分、何かを直すことより、誰を呼ぶかを調べることに費やされてしまいます。

This server moves this knowledge into a place where the assistant can access it, and it makes the time even clear. このcodeの中に込められた設計の判断は、エスカレーション計測の原点を影響の開始としたることです。チケットを20分遅れて開いたからと、対応者に20分の余裕が生まれるわけではない。チケットの作成時刻を起算点とするツールは、黙ってそんな余裕が生されることにするしてしま。

Related MCP server: runframe-mcp-server

4つのツール

Every tool fail close. またしくたニアミっスが黙って解決されてしまうとはな。確信を込めた誤ったエスケレーション乗りは、素直な「わかりません」という言葉よりコストが掛かるからです。

各ツールが実際に返す出力は、失敗パスも含め docs/TRANSCRIPT.mdを参照えて下さい。CIがそのファイルを再生成し、コードが実際の出力とズあるまえにビルドを失敗したもの。

実行する

git clone <this repo> && cd oncall-router-mcp
python -m pip install "pytest>=7"          # the only dependency, and only to run the tests
python -m pytest tests/ -q                 # 40 tests
PYTHONPATH=src python -m oncall_router.server --catalog catalog.toml

これをClaude DesktopやClaude Codえ に組み込むには、MCPクライアントの設定、絶対パスで、以下を追加して下さい:

{
  "mcpServers": {
    "oncall-router": {
      "command": "python",
      "args": ["-m", "oncall_router.server", "--catalog", "/abs/path/to/catalog.toml"],
      "env": { "PYTHONPATH": "/abs/path/to/oncall-router-mcp/src" }
    }
  }
}

そのコマンドを MCP クライアントに指定します。自分のデータを使いる場合は、catalog.tomlをコピーして編集し、--catalog yours.tomlを渡して下さい。コードの変更はいла不要。カログはあくまでデータであり、テストによって同じツールを二つの異なるカタログで実行して証明している。

カタログ

One TOML file containing services, each team the own them, their ownership, eachのエスカレーション chain containing a timing, and runbook steps in each situation. YAMLはhmm: Why TOML not YAML: tomllib ships in Python standard library. Because of that, the catalog doesn't add dependency count to the project.

アリアスは見つけて重要です。インシデント中には、人は覚えているた名前をタイプするものです。gateway でも apigw でも edge でも the gateway でも、すべて api-gateway に解決されます。

これが応意図の中のせぬこと

• No rich integration.とのこと： インシデントのツール、rotationツ、モニタリングを読み込むことはしない。それらは顧客ごとに決めものであり、境界の奥に仕舞がっておく。

• 書込み動作はない。 誰かを本に呼び出す、何かを開、状態を格納する操作は一切ない。質問に答返り、最終判断は人が行う。

• 同梂のカタログは架空物です。catalog.tomlのService、チーム、handle は全部創造。雇いを特定できる情報がレポジトリ内に入ると、テストがビルドを失敗させるです。

• タイミングモデルは慣習であり、標準ではない: 影響の開始から累積时间を、エスカレーションが別のチームに climbするときにも、持継さします。理考え窮まい選択肢であり、唯一の正解でない Choice.

• cost / latch値の記載はない。モデルの呼び出しがないからである。サーバーは定決定論的に、ローカルに動作します。

ゲート

It is structured against the rubric that fixed before the first line of code. 知っておくと得するもの:

• 実のクライアントがワイヤプロトコルを喋下して全ツールが答えます。テスト内で関数呼び出すだけでは終わらない。

• 全ツールが、「当てずっぽうではなく断む」ことを示す失敗パス・テストを持つ。

• の実装が存在する前、テストが失敗すあことを観測できていた。

• カタログ入り替えると、コード編集することなしに全つの答くだが変わることをテストが証明している。

• コミット済みのトランスクリプトを再生成できる、さなければビルドに失敗。

• クレデンシャルなし、ソースにログ記録の通信なし、雇 связи无关内容、サードパーティのインプとート、なし。このゲートはブロックします。