Buildkite

chính thức

Quản lý các pipeline và bản build của Buildkite.

GitHub
52

Bạn có thể làm gì với Buildkite MCP?

  • Liệt kê pipeline — Yêu cầu trợ lý duyệt các pipeline trong tổ chức Buildkite của bạn bằng list_pipelines.
  • Kiểm tra bản build — Truy xuất các bản build gần đây cho một pipeline bằng list_builds và xem chi tiết một bản build cụ thể qua get_build.
  • Xem xét công việc và nhật ký — Liệt kê các công việc trong một bản build bằng list_jobs và lấy đầu ra nhật ký thô cho một công việc bằng get_job_log.
  • Đánh giá kết quả kiểm thử — Truy cập tóm tắt kiểm thử và chi tiết kiểm thử riêng lẻ cho một bản build qua list_tests và get_test.

Tài liệu

buildkite-mcp-server

Build status

Máy chủ Model Context Protocol (MCP) hiển thị dữ liệu Buildkite (pipelines, builds, jobs, tests) cho các công cụ AI và trình soạn thảo.

Tài liệu đầy đủ có sẵn tại buildkite.com/docs/apis/mcp-server.

Sử dụng Thư viện

API Go được xuất ra của mô-đun này nên được coi là không ổn định và có thể có những thay đổi gây hỏng khi chúng tôi phát triển dự án này.

Bảo mật

Để đảm bảo máy chủ MCP chạy trong môi trường an toàn, chúng tôi khuyến nghị chạy nó trong một container.

Image này được xây dựng từ cgr.dev/chainguard/static và chạy dưới quyền người dùng không có đặc quyền.

Truyền header định danh qua chế độ HTTP

Các triển khai HTTP tự lưu trữ có thể chuyển tiếp các header được chọn từ mỗi yêu cầu MCP đến API Buildkite:

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

Lặp lại --passthrough-http-header để cho phép nhiều hơn một header, hoặc đặt giá trị BUILDKITE_PASSTHROUGH_HTTP_HEADERS được phân tách bằng dấu phẩy. Chỉ các header được cho phép rõ ràng mới được chuyển tiếp, và chỉ đến origin được cấu hình bởi BUILDKITE_BASE_URL. Chúng sẽ bị xóa khỏi các yêu cầu được chuyển hướng đến nơi khác.

Để xác thực mỗi yêu cầu MCP bằng token API Buildkite của chính nó, hãy cho phép Authorization và bỏ qua token toàn tiến trình:

BUILDKITE_PASSTHROUGH_HTTP_HEADERS=Authorization \
  buildkite-mcp-server http

Trong chế độ này, mọi yêu cầu /mcp phải chứa chính xác một header Authorization không rỗng. Thiếu thông tin xác thực sẽ trả về HTTP 401; máy chủ không bao giờ quay lại sử dụng token API dùng chung. Proxy ngược phía trước máy chủ MCP chịu trách nhiệm xác thực người gọi và thiết lập hoặc xác thực bất kỳ header định danh nào được chuyển tiếp.

Truyền header không khả dụng trong chế độ stdio. Trước khi phục vụ nhật ký job, máy chủ xác minh rằng người gọi hiện tại có thể truy cập nhật ký job. Việc kiểm tra này được thực hiện cho mọi yêu cầu công cụ nhật ký, kể cả khi dữ liệu nhật ký đã được lưu trong bộ nhớ đệm.

Đóng góp

Hướng dẫn phát triển có trong DEVELOPMENT.md.

Giấy phép

MIT © Buildkite

SPDX-License-Identifier: MIT