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 服务器允许几种不同的配置方法。 它们将按以下顺序使用：

1. 命令行参数
2. 环境变量
3. 配置文件

配置表

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	将服务器日志写入到的路径。

调试

设置 DEBUG=true 环境变量以启用详细日志记录到控制台。

设置日志路径对于使用不将日志打印到控制台的客户端进行调试也很有帮助（说的就是你，Cursor）。

许可证

该项目已获得 MIT 许可证的许可。 有关详细信息，请参见 LICENSE 文件。