Buildkite MCP Server

🚀 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 information about pipelines, builds, and jobs in Buildkite.

✨ Features

Tools

• get_pipeline - Get 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 - Get the logs of a specific job in Buildkite.
• list_artifacts - List all artifacts of a specific job.
• get_artifact - Get a specific artifact of a specific job.
• current_user - Get detailed information about the current user in Buildkite.
• user_token_organization - Get the organization associated with the user token used in the current request.

Here is an example of the get_pipeline tool in action.

📦 Installation

Production Environment

It is recommended to use the pre-built image:

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

Alternatively, you can build it yourself using GoReleaser and copy the binary to the path:

goreleaser build --snapshot --clean

📚 Documentation

Configuration

Create a Buildkite API token with pipeline read access.

Claude Desktop Configuration

If you want to run the buildkite-mcp-server Docker container (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 buildkite-mcp-server installed locally:

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

Visual Studio Code Configuration

In the VS Code environment, you can place the configuration file in the ~/.config/anthropic/ directory:

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

VS Code Configuration Example

{
    // Other configurations...
    "mcp Servers": {
        "buildkite": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "BUILDKITE_API_TOKEN=${env:BUILDKITE_API_TOKEN}",
                "ghcr.io/buildkite/buildkite-mcp-server",
                "stdio"
            ]
        }
    }
}

🤝 Contribution

For build instructions for this project, please refer to Development.md.

⚠️ Disclaimer

This project is still in the early stages of development and is not ready for use.

📄 License

This project is released under the MIT License.