Bazel MCP Server

🚀 Bazel MCP 服務器

Bazel MCP 服務器是一個本地 MCP 服務器，它能為支持 MCP 的 AI 代理提供 Bazel 構建系統的功能。當 MCP 環境中沒有現成的命令行工具，或者因 shell 環境配置錯誤而無法使用 Bazel 時，該服務器就會發揮重要作用。

✨ 主要特性

Bazel MCP 服務器提供了以下實用工具：

• 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 一起使用

可以使用相同的配置與 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. 配置文件

配置表

調試

設置 DEBUG=true 環境變量以啟用詳細日誌。