JinDaGe - nacgarg_bazel-mcp-server MCP Details

article

README

🚀 Bazel MCP 服务器

Bazel MCP 服务器是一个本地 MCP 服务器，它能将 Bazel 构建系统的功能暴露给支持 MCP 的 AI 代理。在 MCP 环境中缺少现有的命令行工具，或者 shell 环境配置错误导致无法使用 Bazel 的情况下，该服务器就会发挥巨大作用。

🚀 快速开始

Bazel MCP 服务器为你提供了便捷的方式，将 Bazel 构建系统的功能集成到支持 MCP 的 AI 代理中。下面为你详细介绍使用方法。

✨ 主要特性

Bazel MCP 服务器提供了丰富的工具，满足你在 Bazel 构建过程中的各种需求：

bazel_build_target：构建指定的 Bazel 目标
bazel_query_target：查询匹配特定模式的目标的依赖关系图
bazel_test_target：运行指定目标的测试
bazel_list_targets：列出工作区中的所有可用目标（需要路径参数，使用 "//" 表示所有目标）
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_path 标志指定 Bazel 二进制文件的路径。

⚠️ 重要提示

此方法在使用 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

你可以使用与 Cursor 相同的配置。

独立运行

# 直接从 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：要使用的 Bazel 二进制文件的路径；--workspace_path：要使用的工作区的路径；--workspace_config：工作区的配置，默认情况下，此配置会使用工作区根目录中的 .bazelrc 文件；--log_path：写入服务器日志的路径。 | | 环境变量 | MCP_BAZEL_PATH、MCP_WORKSPACE_PATH、MCP_WORKSPACE_CONFIG、MCP_LOG_PATH | | 配置文件键 | bazel_path、workspace_path、workspace_config、log_path |

调试

设置 DEBUG=true 环境变量以启用控制台的详细日志记录。设置日志路径对于调试也非常有用，特别是当客户端没有将日志打印到控制台时（例如 Cursor）。

📄 许可证

此项目根据 MIT 许可证发布。有关详细信息，请参阅 LICENSE 文件。

nacgarg_bazel-mcp-server