Nacgarg Bazel MCP Server

🚀 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 服務器支持以下配置方法，按優先級順序使用：

1. 命令行參數
2. 環境變量
3. 配置文件

配置表

調試

設置 DEBUG=true 環境變量以啟用控制檯的詳細日誌記錄。設置日誌路徑對於調試也非常有用，特別是當客戶端沒有將日誌打印到控制檯時（例如 Cursor）。

📄 許可證

此項目根據 MIT 許可證發佈。有關詳細信息，請參閱 LICENSE 文件。