Buildkite

resmi

Mengelola pipeline dan build Buildkite.

Apa yang bisa Anda lakukan dengan Buildkite MCP?

  • Daftar pipeline — Minta asisten untuk menelusuri pipeline organisasi Buildkite Anda menggunakan list_pipelines.
  • Periksa build — Ambil build terbaru untuk suatu pipeline dengan list_builds dan telusuri detail build tertentu melalui get_build.
  • Periksa pekerjaan dan log — Daftarkan pekerjaan dalam suatu build menggunakan list_jobs dan ambil output log mentah untuk suatu pekerjaan dengan get_job_log.
  • Tinjau hasil pengujian — Akses ringkasan pengujian dan detail pengujian individual untuk suatu build melalui list_tests dan get_test.

Dokumentasi

buildkite-mcp-server

Build status

Server Model Context Protocol (MCP) yang mengekspos data Buildkite (pipeline, build, job, pengujian) ke perangkat AI dan editor.

Dokumentasi lengkap tersedia di buildkite.com/docs/apis/mcp-server.


Penggunaan Pustaka

API Go yang diekspor dari modul ini harus dianggap tidak stabil, dan dapat mengalami perubahan yang merusak seiring kami mengembangkan proyek ini.


Keamanan

Untuk memastikan server MCP berjalan di lingkungan yang aman, kami menyarankan untuk menjalankannya di dalam kontainer.

Image ini dibangun dari cgr.dev/chainguard/static dan berjalan sebagai pengguna tanpa hak istimewa.

Meneruskan header identitas melalui mode HTTP

Deployment HTTP yang dihosting sendiri dapat meneruskan header tertentu dari setiap permintaan MCP masuk ke API Buildkite:

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

Ulangi --passthrough-http-header untuk mengizinkan lebih dari satu header, atau atur nilai BUILDKITE_PASSTHROUGH_HTTP_HEADERS yang dipisahkan koma. Hanya header yang diizinkan secara eksplisit yang diteruskan, dan hanya ke origin yang dikonfigurasi oleh BUILDKITE_BASE_URL. Header tersebut dihapus dari permintaan yang dialihkan ke tempat lain.

Untuk mengautentikasi setiap permintaan MCP dengan token API Buildkite-nya sendiri, izinkan Authorization dan hilangkan token seluruh proses:

BUILDKITE_PASSTHROUGH_HTTP_HEADERS=Authorization \
  buildkite-mcp-server http

Dalam mode ini setiap permintaan /mcp harus berisi tepat satu header Authorization yang tidak kosong. Kredensial yang hilang akan mengembalikan HTTP 401; server tidak pernah kembali ke token API bersama. Proxy balik di depan server MCP bertanggung jawab untuk mengautentikasi pemanggil dan mengatur atau memvalidasi header identitas yang diteruskan.

Penerusan header tidak tersedia dalam mode stdio. Sebelum menyajikan log pekerjaan, server memverifikasi bahwa pemanggil saat ini dapat mengakses log pekerjaan. Pemeriksaan ini dilakukan untuk setiap permintaan alat log, termasuk ketika data log sudah di-cache.


Berkontribusi

Panduan pengembangan ada di DEVELOPMENT.md.


Lisensi

MIT © Buildkite

SPDX-License-Identifier: MIT