MCP 服务器

Bazel MCP Server

一个本地 MCP 服务器，向 AI 代理公开 Bazel 构建系统的功能，使它们能够通过自然语言构建、测试、查询和管理 Bazel 项目，即使在无法直接访问 Bazel 的环境中也能实现。

README

Bazel MCP 服务器

一个本地 MCP 服务器，将 Bazel 构建系统的功能暴露给支持 MCP 的 AI 代理。

当 MCP 环境没有现成的命令行工具，或者调用的 shell 环境配置错误导致 Bazel 无法使用时，这非常有用。

工具

Bazel MCP 服务器提供以下工具：

bazel_build_target: 构建指定的 Bazel 目标
bazel_query_target: 查询与模式匹配的目标的依赖关系图
bazel_test_target: 运行指定目标的测试
bazel_list_targets: 列出工作区中所有可用的目标（需要 path 参数，使用 "//" 表示所有目标）
bazel_fetch_dependencies: 获取外部依赖
bazel_set_workspace_path: 在运行时更改 Bazel 工作区路径

每个命令（除了 bazel_set_workspace_path）都支持一个可选的 additionalArgs 参数，允许将额外的参数传递给底层的 Bazel 命令。这对于指定诸如 --verbose_failures 或 --test_output=all 之类的标志非常有用。

用法

安装

与 Cursor 一起使用

将以下内容添加到 .cursor/mcp.json。

您无需提供工作区路径，因为 LLM 可以使用 set_workspace_path 在运行时更改工作区路径。

bazel 二进制文件通常会自动被拾取，但如果您遇到问题，可以使用 --bazel_path 标志提供 bazel 二进制文件的路径。

:warning: 请注意，当将 Cursor 与远程 SSH 会话一起使用时，这将不起作用，因为它会在本地运行 MCP 服务器。

{
  "mcpServers": {
    "bazel": {
      "command": "npx",
      "args": [
        "-y",
        "github:nacgarg/bazel-mcp-server",

        // 如果您需要指定 bazel 二进制文件路径
        "--bazel_path", 
        "/absolute/path/to/your/bazel/binary",

        // 如果您需要指定工作区路径
        "--workspace_path",
        "/absolute/path/to/your/bazel/workspace"

        // 有关更多选项，请参见下面的配置表
      ]
    }
  }
}

与 Claude Desktop 一起使用

您可以将与上面相同的配置与 Claude Desktop 一起使用。

独立启动

# 直接从 GitHub 运行（无需安装）
npx -y github:nacgarg/bazel-mcp-server

# 从源代码
git clone https://github.com/nacgarg/bazel-mcp-server.git
cd bazel-mcp-server
npm install
npm run build
dist/index.js

配置

此 MCP 服务器允许几种不同的配置方法。它们将按以下顺序使用：

命令行参数
环境变量
配置文件

配置表

CLI 参数	环境变量	配置文件键	描述
`--bazel_path`	`MCP_BAZEL_PATH`	`bazel_path`	要使用的 Bazel 二进制文件的路径。
`--workspace_path`	`MCP_WORKSPACE_PATH`	`workspace_path`	要使用的 Bazel 工作区的路径。
`--workspace_config`	`MCP_WORKSPACE_CONFIG`	`workspace_config`	要使用的工作区的配置。默认情况下，这使用工作区根目录中的 `.bazelrc` 文件。
`--log_path`	`MCP_LOG_PATH`	`log_path`	用于写入服务器日志的路径。