Buildkite MCP 服务器

一个通过模型上下文协议 (MCP) 从 Buildkite 检索信息的微服务。

设置

1. 克隆此仓库
2. 运行 npm install
3. 设置 BUILDKITE_ACCESS_TOKEN 环境变量
4. 使用 node index.js 启动服务器

与 Cursor 一起使用 (MCP 集成)

要将此服务器添加到 Cursor，您需要在 ~/.cursor/config/mcp.json 文件中进行配置：

{
  "mcpServers": {
    "buildkite": {
      "command": "npx",
      "args": [
        "-y",
        "@drew-goddyn/buildkite-mcp"
      ],
      "env": {
        "BUILDKITE_ACCESS_TOKEN": "your-buildkite-access-token"
      }
    }
  }
}

通过此配置：

• 您无需手动安装或运行服务器
• Cursor 将根据需要自动启动和停止服务器
• 将 your-buildkite-access-token 替换为您实际的 Buildkite API 令牌

更新配置后，重启 Cursor 以应用更改。

MCP 端点

列出组织

POST /mcp_buildkite_list_organizations

请求体:

{
  "access_token": "optional-if-set-in-env"
}

响应:

[
  {
    "id": "org-id",
    "name": "Organization Name",
    "slug": "organization-slug"
  }
]

列出流水线

POST /mcp_buildkite_list_pipelines

请求体:

{
  "organization": "my-org",
  "access_token": "optional-if-set-in-env"
}

响应:

[
  {
    "id": "pipeline-id",
    "name": "Pipeline Name",
    "slug": "pipeline-slug"
  }
]

列出构建

POST /mcp_buildkite_list_builds

请求体:

{
  "organization": "my-org",
  "pipeline": "my-pipeline",
  "access_token": "optional-if-set-in-env",
  "branch": "main",
  "state": "failed",
  "per_page": 10,
  "page": 1
}

响应:

[
  {
    "id": "build-id",
    "number": 123,
    "state": "failed"
  }
]

获取构建详情

POST /mcp_buildkite_get_build

请求体:

{
  "organization": "my-org",
  "pipeline": "my-pipeline",
  "build_number": 123,
  "access_token": "optional-if-set-in-env"
}

响应:

{
  "id": "build-id",
  "number": 123,
  "jobs": [
    {
      "id": "job-id",
      "name": "Job Name",
      "state": "failed"
    }
  ]
}

列出所有任务

POST /mcp_buildkite_list_jobs

请求体:

{
  "organization": "my-org",
  "pipeline": "my-pipeline",
  "build_number": 123,
  "access_token": "optional-if-set-in-env"
}

响应:

[
  {
    "id": "job-id",
    "name": "Job Name",
    "state": "failed"
  }
]

列出失败的任务

POST /mcp_buildkite_list_failed_jobs

请求体:

{
  "organization": "my-org",
  "pipeline": "my-pipeline",
  "build_number": 123,
  "access_token": "optional-if-set-in-env"
}

响应:

[
  {
    "id": "01234567-89ab-cdef-0123-456789abcdef",
    "name": "Test Job",
    "state": "failed",
    "web_url": "https://buildkite.com/my-org/my-pipeline/builds/123#01234567-89ab-cdef-0123-456789abcdef"
  }
]

列出任务规范失败

POST /mcp_buildkite_list_job_spec_failures

请求体:

{
  "organization": "my-org",
  "pipeline": "my-pipeline",
  "build_number": 123,
  "job_id": "01234567-89ab-cdef-0123-456789abcdef",
  "access_token": "optional-if-set-in-env"
}

响应:

[
  {
    "type": "RSpec",
    "spec": "./spec/path/to/file_spec.rb:123",
    "message": "Expected result to be X but got Y"
  }
]

获取任务日志

POST /mcp_buildkite_get_job_log

请求体:

{
  "organization": "my-org",
  "pipeline": "my-pipeline",
  "build_number": 123,
  "job_id": "01234567-89ab-cdef-0123-456789abcdef",
  "access_token": "optional-if-set-in-env",
  "limit": 100  // optional, defaults to all content
}

响应:

{
  "content": "...log content...",
  "size": 12345,
  "format": "raw"
}

从构建 URL 列出失败的 Specs

POST /mcp_buildkite_list_failed_specs

请求体:

{
  "build_url": "https://buildkite.com/my-org/my-pipeline/builds/123",
  "access_token": "optional-if-set-in-env"
}

响应:

{
  "build_url": "https://buildkite.com/my-org/my-pipeline/builds/123",
  "failed_job_count": 2,
  "jobs": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "name": "Test Job 1",
      "web_url": "https://buildkite.com/my-org/my-pipeline/builds/123#01234567-89ab-cdef-0123-456789abcdef",
      "failures": [
        {
          "spec": "./spec/path/to/file_spec.rb:123",
          "message": "Expected result to be X but got Y"
        }
      ]
    },
    {
      "id": "fedcba98-7654-3210-fedc-ba9876543210",
      "name": "Test Job 2",
      "web_url": "https://buildkite.com/my-org/my-pipeline/builds/123#fedcba98-7654-3210-fedc-ba9876543210",
      "failures": []
    }
  ],
  "failures": [
    {
      "job_id": "01234567-89ab-cdef-0123-456789abcdef",
      "job_name": "Test Job 1",
      "job_url": "https://buildkite.com/my-org/my-pipeline/builds/123#01234567-89ab-cdef-0123-456789abcdef",
      "spec": "./spec/path/to/file_spec.rb:123",
      "message": "Expected result to be X but got Y"
    }
  ]
}

重试任务

POST /mcp_buildkite_retry_job

请求体:

{
  "organization": "my-org",
  "pipeline": "my-pipeline",
  "build_number": 123,
  "job_id": "01234567-89ab-cdef-0123-456789abcdef",
  "access_token": "optional-if-set-in-env"
}

响应:

{
  "id": "job-id",
  "state": "scheduled"
}

列出流水线构建失败

POST /mcp_buildkite_list_pipeline_build_failures

请求体:

{
  "organization": "my-org",
  "pipeline": "my-pipeline",
  "state": "finished",
  "per_page": 10,
  "page": 1,
  "access_token": "optional-if-set-in-env"
}

响应:

[
  {
    "build_number": 123,
    "build_url": "https://buildkite.com/my-org/my-pipeline/builds/123",
    "failed_jobs": [
      {
        "name": "Test Job",
        "url": "https://buildkite.com/my-org/my-pipeline/builds/123#01234567-89ab-cdef-0123-456789abcdef"
      }
    ]
  }
]

环境变量

• BUILDKITE_ACCESS_TOKEN: 您的 Buildkite API 令牌，具有读取权限
• PORT: (可选) 运行服务器的端口 (默认: 63330)

错误处理

当出现问题时，服务器会返回适当的 HTTP 状态代码和错误消息：

• 400: Bad Request - 缺少或无效的参数
• 401: Unauthorized - 无效或缺失的访问令牌
• 404: Not Found - 找不到资源
• 500: Internal Server Error - 服务器端错误