Buildkite MCP

🚀 Buildkite API 服務器文檔

本服務器提供了一系列與 Buildkite 平臺交互的接口，可幫助您執行各類操作，如檢索構建信息、重試作業等，為您的開發和運維工作提供便利。

🚀 快速開始

在使用本服務器的接口前，請確保您已經設置好相應的環境變量：

• BUILDKITE_ACCESS_TOKEN：您的 Buildkite API 令牌，需具備讀取權限。
• PORT（可選）：服務器運行的端口，默認值為 63330。

✨ 主要特性

本服務器提供了一系列與 Buildkite 平臺交互的接口，允許您執行各種操作，如檢索構建信息、重試作業等。

📚 詳細文檔

接口列表

1. 檢索構建信息

• 接口名稱：/build-info
• 請求方法：GET
• 參數：build_url（必填）
• 響應：返回指定構建的詳細信息，包括作業狀態和失敗信息。

2. 重試作業

• 接口名稱：/retry-job
• 請求方法：POST
• 請求體：

{
  "organization": "my-org",
  "pipeline": "my-pipeline", 
  "build_number": 123,
  "job_id": "01234567-89ab-cdef-0123-456789abcdef",
  "access_token": "your-token"
}

• 響應：返回重試作業的狀態。

3. 檢索構建失敗信息

• 接口名稱：/build-failures
• 請求方法：POST
• 請求體：

{
  "organization": "my-org",
  "pipeline": "my-pipeline", 
  "state": "finished",
  "per_page": 10,
  "page": 1,
  "access_token": "your-token"
}

• 響應：返回指定管道中失敗構建的列表，包括每個構建的作業信息。

🔧 技術細節

環境變量

錯誤處理

服務器在出現錯誤時返回適當的 HTTP 狀態碼和錯誤消息：

• 400：請求錯誤 - 缺少或無效參數
• 401：未授權 - 無效或缺少訪問令牌
• 404：資源未找到
• 500：服務器內部錯誤