Buildkite

ทางการ

จัดการไปป์ไลน์และบิลด์ของ Buildkite

GitHub

คุณทำอะไรได้บ้างด้วย Buildkite MCP?

แสดงรายการไปป์ไลน์ — ขอให้ผู้ช่วยเรียกดูไปป์ไลน์ขององค์กร Buildkite ของคุณโดยใช้ list_pipelines
ตรวจสอบบิลด์ — ดึงข้อมูลบิลด์ล่าสุดสำหรับไปป์ไลน์ด้วย list_builds และเจาะลึกข้อมูลบิลด์เฉพาะผ่าน get_build
ตรวจสอบงานและบันทึก — แสดงรายการงานภายในบิลด์โดยใช้ list_jobs และดึงข้อมูลบันทึกดิบของงานด้วย get_job_log
ตรวจสอบผลการทดสอบ — เข้าถึงสรุปผลการทดสอบและรายละเอียดการทดสอบแต่ละรายการสำหรับบิลด์ผ่าน list_tests และ get_test

เอกสาร

buildkite-mcp-server

เซิร์ฟเวอร์ Model Context Protocol (MCP) ที่เปิดเผยข้อมูล Buildkite (pipelines, builds, jobs, tests) ให้กับเครื่องมือ AI และ editor

เอกสารฉบับเต็มมีอยู่ที่ buildkite.com/docs/apis/mcp-server

การใช้งานไลบรารี

Go API ที่ถูก export ของโมดูลนี้ควรถือว่าไม่เสถียร และอาจมีการเปลี่ยนแปลงที่ทำให้เกิดความไม่เข้ากันได้ในขณะที่เราพัฒนาโปรเจกต์นี้

ความปลอดภัย

เพื่อให้แน่ใจว่าเซิร์ฟเวอร์ MCP ทำงานในสภาพแวดล้อมที่ปลอดภัย เราแนะนำให้รันในคอนเทนเนอร์

อิมเมจนี้สร้างจาก cgr.dev/chainguard/static และรันในฐานะผู้ใช้ที่ไม่มีสิทธิ์พิเศษ

การส่งต่อส่วนหัวข้อมูลประจำตัวผ่านโหมด HTTP

การปรับใช้ HTTP แบบ self-hosted สามารถส่งต่อส่วนหัวที่เลือกจากคำขอ 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 token ของตัวเอง ให้อนุญาต Authorization และละเว้น token ระดับกระบวนการ:

BUILDKITE_PASSTHROUGH_HTTP_HEADERS=Authorization \
  buildkite-mcp-server http

ในโหมดนี้ ทุกคำขอ /mcp จะต้องมีส่วนหัว Authorization ที่ไม่ว่างเปล่าหนึ่งรายการพอดี ข้อมูลประจำตัวที่ขาดหายไปจะส่งคืน HTTP 401; เซิร์ฟเวอร์จะไม่ถอยกลับไปใช้ API token ที่ใช้ร่วมกัน reverse proxy ที่อยู่ด้านหน้าเซิร์ฟเวอร์ MCP มีหน้าที่ตรวจสอบสิทธิ์ผู้เรียกและตั้งค่าหรือตรวจสอบส่วนหัวข้อมูลประจำตัวที่ส่งต่อ

การส่งต่อส่วนหัวไม่สามารถใช้ได้ในโหมด stdio ก่อนที่จะให้บริการบันทึกของ job เซิร์ฟเวอร์จะตรวจสอบว่าผู้เรียกปัจจุบันสามารถเข้าถึงบันทึกของ job นั้นได้หรือไม่ การตรวจสอบนี้จะดำเนินการสำหรับทุกคำขอเครื่องมือบันทึก รวมถึงเมื่อข้อมูลบันทึกถูกแคชไว้แล้ว

การมีส่วนร่วม

แนวทางการพัฒนาอยู่ใน DEVELOPMENT.md

ใบอนุญาต

SPDX-License-Identifier: MIT