Nacgarg Bazel MCP Server

🚀 Bazel MCP サーバー

このサーバーは、ローカルの MCP サーバーであり、Bazel ビルドシステムの機能を MCP 対応の AI エージェントに公開します。

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 を使用する場合

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 ファイルを参照してください。