Buildkite

公式

Buildkiteのパイプラインとビルドを管理します。

GitHub
52

Buildkite MCPで何ができますか？

  • パイプラインの一覧表示 — アシスタントに依頼して、list_pipelines を使用してBuildkite組織のパイプラインを閲覧します。
  • ビルドの調査 — list_builds を使用してパイプラインの最近のビルドを取得し、get_build で特定のビルドの詳細を掘り下げます。
  • ジョブとログの確認 — list_jobs を使用してビルド内のジョブを一覧表示し、get_job_log でジョブの生のログ出力を取得します。
  • テスト結果のレビュー — list_tests と get_test を使用して、ビルドのテストサマリーと個別のテスト詳細にアクセスします。

ドキュメント

buildkite-mcp-server

Build status

Model Context Protocol (MCP) サーバー。Buildkite のデータ（パイプライン、ビルド、ジョブ、テスト）を AI ツールやエディタに公開します。

完全なドキュメントは buildkite.com/docs/apis/mcp-server でご覧いただけます。

ライブラリの使用

このモジュールのエクスポートされた Go API は不安定と見なされるべきであり、プロジェクトの進化に伴い破壊的変更の対象となります。

セキュリティ

MCP サーバーを安全な環境で実行するために、コンテナ内での実行を推奨します。

このイメージは cgr.dev/chainguard/static からビルドされ、非特権ユーザーとして実行されます。

HTTP モードでの ID ヘッダーの受け渡し

セルフホスト HTTP デプロイメントでは、受信 MCP リクエストから選択されたヘッダーを Buildkite API に転送できます。

BUILDKITE_API_TOKEN=bkua_xxx \
  buildkite-mcp-server http \
  --passthrough-http-header X-User-Identity

複数のヘッダーを許可するには --passthrough-http-header を繰り返すか、カンマ区切りの BUILDKITE_PASSTHROUGH_HTTP_HEADERS 値を設定します。明示的に許可されたヘッダーのみが転送され、転送先は BUILDKITE_BASE_URL で設定されたオリジンに限定されます。他の場所にリダイレクトされるリクエストからは削除されます。

各 MCP リクエストを独自の Buildkite API トークンで認証するには、Authorization を許可し、プロセス全体のトークンを省略します。

BUILDKITE_PASSTHROUGH_HTTP_HEADERS=Authorization \
  buildkite-mcp-server http

このモードでは、すべての /mcp リクエストに、空でない Authorization ヘッダーが 1 つだけ含まれている必要があります。資格情報がない場合は HTTP 401 が返され、サーバーが共有 API トークンにフォールバックすることはありません。MCP サーバーの前段にあるリバースプロキシは、呼び出し元の認証と、転送される ID ヘッダーの設定または検証を担当します。

ヘッダー転送は stdio モードでは利用できません。ジョブログを提供する前に、サーバーは現在の呼び出し元がジョブログにアクセスできることを確認します。このチェックは、ログデータが既にキャッシュされている場合を含め、すべてのログツールリクエストに対して実行されます。

貢献

開発ガイドラインは DEVELOPMENT.md にあります。

ライセンス

MIT © Buildkite

SPDX-License-Identifier: MIT