Bazel Mcp

Bazel MCP

一个 Model Context Protocol 服务，可向 AI 助手提供 Bazel 构建系统的功能。

仓库：github.com/saeid-rez/bazel-mcp

工具

工具	描述
bazel_query	运行任意 bazel query 表达式
bazel_cquery	运行已配置的 bazel cquery 表达式（select() 和平台）
bazel_aquery	运行操作 bazel aquery 表达式（编译器标志、命令）
list_targets	列出软件包或子树中的目标
get_deps	获取目标的直接或传递依赖项
get_rdeps	获取指定范围内的反向依赖项
get_dependency_path	跟踪目标之间的依赖链（somepath/allpaths）
show_target_info	通过 query --output=build 查看规则定义
find_affected_targets	查找受变更文件影响的目标
bazel_build	运行 bazel build，并提供结构化失败诊断
bazel_test	运行 bazel test，并提供结构化目标及失败用例结果
bazel_run	运行 bazel run，支持参数、环境变量和工作目录控制
explain_build_file	读取 BUILD 文件内容以供分析

用法

需要 uv。如果 MCP 客户端未从 Bazel 工作区启动服务，请使用 Bazel 工作区路径配置服务。

Antigravity (agy)

将以下内容添加到 ~/.gemini/config/mcp_config.json：

{
  "mcpServers": {
    "bazel": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/saeid-rez/bazel-mcp",
        "bazel-mcp-server"
      ]
    }
  }
}

默认情况下，Bazel 命令会在当前活动工作区中运行。如果 Antigravity 未从你的 Bazel 工作区启动服务，请显式传入 --workspace-root：

{
  "mcpServers": {
    "bazel": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/saeid-rez/bazel-mcp",
        "bazel-mcp-server",
        "--workspace-root",
        "/path/to/your/bazel/workspace"
      ]
    }
  }
}

OpenCode

将以下内容添加到 opencode.json 或 opencode.jsonc。将 /path/to/your/bazel/workspace 替换为 Bazel 工作区的绝对路径。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bazel": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "git+https://github.com/saeid-rez/bazel-mcp",
        "bazel-mcp-server",
        "--workspace-root",
        "/path/to/your/bazel/workspace"
      ],
      "enabled": true
    }
  }
}

GitHub Copilot CLI

将以下内容添加到 ~/.copilot/mcp-servers.json。将 /path/to/your/bazel/workspace 替换为 Bazel 工作区的绝对路径。

{
  "mcp": {
    "servers": {
      "bazel": {
        "command": "uvx",
        "args": [
          "--from",
          "git+https://github.com/saeid-rez/bazel-mcp",
          "bazel-mcp-server",
          "--workspace-root",
          "/path/to/your/bazel/workspace"
        ],
        "protocol": "stdio"
      }
    }
  }
}

或者，在 Copilot CLI 中运行 /mcp add bazel，并提供相同的命令和参数。

使用 uv 安装

若要持久安装服务，而不是从 GitHub 运行，请执行：

uv tool install bazel-mcp-server

然后使用以下已安装服务配置，替代上面的基于 GitHub 的命令。如果客户端未从 Bazel 工作区启动服务，请添加 --workspace-root 及其路径。

Antigravity (agy)：

{
  "mcpServers": {
    "bazel": {
      "command": "bazel-mcp-server",
      "args": ["--workspace-root", "/path/to/your/bazel/workspace"]
    }
  }
}

OpenCode：

{
  "mcp": {
    "bazel": {
      "type": "local",
      "command": ["bazel-mcp-server", "--workspace-root", "/path/to/your/bazel/workspace"],
      "enabled": true
    }
  }
}

GitHub Copilot CLI：

{
  "mcp": {
    "servers": {
      "bazel": {
        "command": "bazel-mcp-server",
        "args": ["--workspace-root", "/path/to/your/bazel/workspace"],
        "protocol": "stdio"
      }
    }
  }
}

Cursor

将以下内容添加到 Bazel 工作区中的 .cursor/mcp.json。

{
  "mcpServers": {
    "bazel": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/saeid-rez/bazel-mcp", "bazel-mcp-server"]
    }
  }
}

默认情况下，Bazel 命令会在当前打开的工作区中运行。

如果 Cursor 未从 Bazel 工作区启动服务，请显式传入工作区路径：

{
  "mcpServers": {
    "bazel": {
      "command": "uvx",
      "args": [
        "bazel-mcp-server",
        "--workspace-root",
        "/path/to/your/bazel/workspace"
      ]
    }
  }
}

其他可选标志：

bazel-mcp-server --bazel-path bazelisk --timeout 600 --max-output-chars 64000

开发

克隆仓库并在本地运行测试：

git clone https://github.com/saeid-rez/bazel-mcp
cd bazel-mcp
uv sync --group dev
uv run pytest