Buildkite MCP Server Ndy

🚀 Build Buildkite-MCP-Server

This is a Model Context Protocol (MCP) server built for Buildkite. The goal is to provide tools (such as Claude Desktop, GitHub Copilot, and other tools or editors) with access to pipeline, build, and job information in Buildkite.

✨ Features

• get_pipeline - Retrieve detailed information about a specific pipeline in Buildkite.
• list_pipelines - List all pipelines in a Buildkite organization.
• list_builds - List all builds in a specific pipeline.
• get_job_logs - Retrieve the logs of a specific job in Buildkite.
• list_artifacts - List all artifacts of a specific job.
• get_artifact - Retrieve a specific artifact from a specific job.
• current_user - Retrieve detailed information about the current user in Buildkite.
• user_token_organization - Retrieve the organization associated with the user token used in the request.

Here is a practical example of the get_pipeline tool.

📦 Installation

Production Environment

It is recommended to use the pre-built Docker image (recommended):

docker pull ghcr.io/buildkite/buildkite-mcp-server

Alternatively, build and run the binary using GoReleaser:

goreleaser build --snapshot --clean

📚 Documentation

Configuration

Create a Buildkite API token with pipeline read access.

Claude Desktop Configuration

If you want to run the server buildkite-mcp-server using Docker (recommended):

{
    "mcpServers": {
        "buildkite": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "BUILDKITE_API_TOKEN",
                "ghcr.io/buildkite/buildkite-mcp-server",
                "stdio"
            ],
            "env": {
                "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx"
            }
        }
    }
}

If you have installed buildkite-mcp-server locally:

{
    "mcpServers": {
        "buildkite": {
            "command": "buildkite-mcp-server",
            "args": [
                "stdio"
            ],
            "env": {
                "BUILDKITE_API_TOKEN": "bkua_xxxxxxxx"
            }
        }
    }
}

Goose Configuration

Use Docker with Goose (recommended):

extensions:
  fetch:
    name: Buildkite
    command: docker
    args:
      - run
      - -i
      - --rm
      - -e
      - BUILDKITE_API_TOKEN
      - ghcr.io/buildkite/buildkite-mcp-server
      - stdio
    env:
      BUILDKITE_API_TOKEN: "bkua_xxxxxxxx"

If you have installed buildkite-mcp-server locally:

extensions:
  buildkite-mcp-server:
    command: buildkite-mcp-server
    args:
      - stdio
    env:
      BUILDKITE_API_TOKEN: "bkua_xxxxxxxx"

🤝 Contribution

To contribute to this project, please refer to Development.md for more information.

⚠️ Disclaimer

This project is for reference only. Please read the relevant documentation carefully and ensure you understand all potential risks before use.

📄 License

This project is licensed under the terms of the LICENSE file.