Bazel MCP Server

🚀 Bazel MCP サーバー

Bazel ビルドシステムの機能を MCP 対応の AI エージェントに提供するローカルの MCP サーバーです。

MCP 環境に既存のコマンドラインツールがない場合、またはシェル環境の設定が誤っていて 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 環境変数を設定して、詳細なログを有効にします。