🚀 构建 Buildkite-MCP-Server

这是一个为 Buildkite 构建的 模型上下文协议 (MCP) 服务器。其目标是为工具（如 Claude Desktop、GitHub Copilot 以及其他工具或编辑器）提供对 Buildkite 中管道、构建和作业信息的访问。

🚀 快速开始

生产环境

建议使用预构建的 Docker 镜像（推荐）：

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

或者使用 GoReleaser 构建并运行二进制文件：

goreleaser build --snapshot --clean

✨ 主要特性

工具列表

• get_pipeline - 获取特定管道在 Buildkite 中的详细信息
• list_pipelines - 列出 Buildkite 组织中的所有管道
• list_builds - 列出特定管道中的所有构建
• get_job_logs - 获取特定作业在 Buildkite 中的日志
• list_artifacts - 列出特定作业的所有工件
• get_artifact - 获取特定作业中的特定工件
• current_user - 获取当前用户在 Buildkite 中的详细信息
• user_token_organization - 获取与请求中使用的用户令牌关联的组织

以下是 get_pipeline 工具的实际操作示例。

📦 安装指南

配置

创建一个具有管道读取访问权限的 Buildkite API 令牌。

Claude Desktop 配置

如果要使用 Docker 运行服务器 buildkite-mcp-server（推荐）：

{
    "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"
            }
        }
    }
}

如果你已经安装了 buildkite-mcp-server 本地：

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

Goose 配置

使用 Docker 与 Goose（推荐）：

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"

如果你已经安装了 buildkite-mcp-server 本地：

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

📚 详细文档

要为这个项目做出贡献，请参考 Development.md 以获取更多信息。

📄 许可证

此项目的授权遵循 LICENSE 文件中的条款。

⚠️ 重要提示

本项目仅供参考，使用前请仔细阅读相关文档并确保你了解所有潜在风险。