Bazel MCP Server

基本能力

产品定位

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

核心功能

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

适用场景

• 当 MCP 环境中没有现有的命令行工具时
• 当调用的 shell 环境配置错误导致无法使用 Bazel 时

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

使用 Cursor

在 .cursor/mcp.json 中添加以下配置：

{
  "mcpServers": {
    "bazel": {
      "command": "npx",
      "args": [
        "-y",
        "github:nacgarg/bazel-mcp-server",
        "--bazel_path", 
        "/absolute/path/to/your/bazel/binary",
        "--workspace_path",
        "/absolute/path/to/your/bazel/workspace"
      ]
    }
  }
}

独立运行

# 直接从 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

调试方式

设置 DEBUG=true 环境变量以启用详细日志记录到控制台。 设置日志路径也有助于调试不将日志打印到控制台的客户端。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。