Buildkite

官方

管理 Buildkite 的管道與建置。

GitHub

你可以用 Buildkite MCP 做什麼？

列出管道 — 要求助手使用 list_pipelines 瀏覽您的 Buildkite 組織的管道。
檢查建置 — 使用 list_builds 擷取某個管道的近期建置，並透過 get_build 深入查看特定建置的詳細資訊。
檢視作業與日誌 — 使用 list_jobs 列出建置中的作業，並透過 get_job_log 取得作業的原始日誌輸出。
檢閱測試結果 — 透過 list_tests 和 get_test 存取建置的測試摘要與個別測試詳細資訊。

文件

buildkite-mcp-server

Model Context Protocol (MCP) 伺服器，可將 Buildkite 資料（管線、建置、作業、測試）提供給 AI 工具和編輯器使用。

完整文件請參閱 buildkite.com/docs/apis/mcp-server。

程式庫使用方式

此模組匯出的 Go API 應視為不穩定，隨著專案發展，可能會發生破壞性變更。

安全性

為確保 MCP 伺服器在安全的環境中執行，我們建議在容器中執行它。

此映像檔是從 cgr.dev/chainguard/static 建置，並以非特權使用者身分執行。

透過 HTTP 模式傳遞身分標頭

自行託管的 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 設定的來源。這些標頭會從重新導向到其他位置的請求中移除。

若要使用各自的 Buildkite API 權杖驗證每個 MCP 請求，請允許 Authorization 並省略整個程序的權杖：

BUILDKITE_PASSTHROUGH_HTTP_HEADERS=Authorization \
  buildkite-mcp-server http

在此模式下，每個 /mcp 請求都必須包含恰好一個非空的 Authorization 標頭。缺少憑證會回傳 HTTP 401；伺服器絕不會退回到使用共享的 API 權杖。MCP 伺服器前方的反向代理負責驗證呼叫者，並設定或驗證任何轉發的身分標頭。

標頭傳遞功能在 stdio 模式下無法使用。在提供作業日誌之前，伺服器會驗證目前的呼叫者是否可以存取該作業日誌。每次日誌工具請求都會執行此檢查，包括日誌資料已快取時。

貢獻

開發指南請參閱 DEVELOPMENT.md。

授權

SPDX-License-Identifier: MIT