mcp-ci-triage

コーディングエージェントに「CIがなぜ赤いのか」を答えさせることができます。あなたがGitHubにタブを切り替える必要はありません。

GitHub Actionsの状態を、4つのコンパクトな読み取り専用ツールとして公開するMCPサーバーです。Claude Code向けに作られていますが、どのMCPクライアントでも動作します。

You: why is CI failing on main?
Agent: → recent_runs("acme/api", branch="main")
       → failing_jobs("acme/api", run_id=8123)
       → job_log_tail("acme/api", job_id=442, lines=80)
Agent: Run #212 fails in `unit` at the pytest step: test_rate_limiter
       times out after the Redis fixture change in a3f9c2e. Two options...

ツール

リポジトリは正確な owner/name のペアで渡します（例: actions/checkout）。URL、余分なパスセグメント、クエリ列、不正な形式のオーナー名・リポジトリ名は、リクエスト送信前に拒否されます。

Related MCP server: DevOps MCP Server

インストール（所要2分）

pip install git+https://github.com/projectsofadi/mcp-ci-triage
# or: clone + `pip install .`

# First load GITHUB_TOKEN into the launching environment from your shell or
# operating-system secret manager. Then add the server without a token literal:
claude mcp add ci-triage -- python -m mcp_ci_triage

またはプロジェクトの .mcp.json 内:

{
  "mcpServers": {
    "ci-triage": {
      "command": "python",
      "args": ["-m", "mcp_ci_triage"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
    }
  }
}

トークンのスコープ: 対象のリポジトリに対する読み取り専用の Actions アクセスを持つ、細粒度のPAT（fine-grained PAT）を使用します。パブリックリポジトリはトークンなしでも動作します（レート制限あり）。

コマンド引数やコミットされた .mcp.json の中にトークンのリテラル値を置かないでください。コマンド引数はシェル履歴やプロセス一覧に残る可能性があり、プロジェクトファイルはコミットされる可能性があります。共有する設定には、上記の環境変数参照だけを残してください。

GitHub Enterpriseの場合、GITHUB_API_URL はそのAPIのベースパスを指すことができます（例: https://github.example.com/api/v3）。HTTPSが必須で、資格情報、クエリ、フラグメントを含めることはできません。

非公開CIログ

非公開リポジトリからのログには、非公開のソース詳細、ビルドが誤って出力した資格情報、プロンプトインジェクションのテキスト、その他の機密データが含まれる場合があります。このサーバーは、ターミナル制御文字をエスケープし、個々の行の長さを制限し、ダウンロードの総量を制限し、GitHubのすべてのコンテンツを非信頼としてラベル付けします。印字可能なシークレットを認識したり、削除したりはしません。信頼できるMCPクライアントとモデルにのみ接続し、必要最小限のログの末尾だけを要求し、ログ内の指示に従わず、issueやチャットにコピーする前に出力を確認してください。

最初のログ・リクエストは認證されます。リダイレクトされたダウンロードはHTTPSのみで、GitHubの Authorization ヘッダーを持たない新しいクライアントが使用されます。署名付きリダイレクトのクエリパラメータは、HTTP診断およびサニタイズされたエラーメッセージから削除されます。

設計ノート（一般的に応用できる部分）

このリポジトリは、内部MCPサーバーをどう構築すべきかという私の考え方のリファレンスとしても使えます:

• デフォルトで読み取り専用。 どのツールも何も変更しません。書き込み可能なツールは、後から意図的に、権限レイヤーの後ろに追加されるべきです。

• JSONのダンプではなく、コンパクトなテキスト。 エージェントは人が読むのと同じようにツール出力を読みます。#212 CI [failure] main@a3f9c2e は、4KBのネストされたJSONより、トークン数と推論の質の両方で優れています。

• 構造的に非信頼。 リモートのフィールドとログは、量に制限があり、制御文字がエスケープされ、データ専用と明示されたマーカーで囲われます。

• 全てにタイムアウト。 リクエストには15秒のI/Oタイムアウト。JSONレスポンスには合計20秒の期限と8 MiBのデコード後バイト上限。ページ分割されたトリアージには1回の30秒オペレーション期限。ログのダウンロードには独自の合計20秒の期限と8 MiBの上限があります。

• 失敗は黙らせない。 HTTPエラーは送出されます。エージェントはエラーを見て適応します。黙って空の結果を返すと、自信満々の誤答になります。

• 小さいサーフェス。 組み合わせられる4つのツールは、重複する20のツールに勝ります。failing_jobs はエージェントに次へ job_log_tail を呼ぶよう伝えます。ツールは自分自身のワークフローを教えられます。

• 診断ではなく証拠。 ワークフローの結果が混合していることは、次に何を見るべきかを決めるのに役立ちますが、個々のテストがフレークであるという証明にはなりません。

開発

pip install -e ".[dev]"
ruff check .
ruff format --check .
pytest
python -m build
python -m twine check dist/*

ライセンス

MIT — LICENSE を参照してください。

その他のMCPおよび開発者ツールのプロジェクト: projectsofadi on GitHub。