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などのフラグを指定する場合に便利です。

Related MCP server: Linear

使用法

インストール

カーソルの使用

.cursor/mcp.jsonに以下を追加します。

LLM はset_workspace_pathを使用して実行時にワークスペースパスを変更できるため、ワークスペースパスを指定する必要はありません。

通常、bazel バイナリは自動的に選択されますが、問題が発生した場合は、 --bazel_pathフラグを使用して bazel バイナリへのパスを指定できます。

:warning: カーソルをリモート SSH セッションで使用する場合、MCP サーバーがローカルで実行されるため、これは機能しないことに注意してください。

{
  "mcpServers": {
    "bazel": {
      "command": "npx",
      "args": [
        "-y",
        "github:nacgarg/bazel-mcp-server",

        // If you need to specify the bazel binary path
        "--bazel_path", 
        "/absolute/path/to/your/bazel/binary",

        // If you need to specify the workspace path
        "--workspace_path",
        "/absolute/path/to/your/bazel/workspace"

        // See Configuration Table below for more options
      ]
    }
  }
}

Claude Desktopでの使用

Claude Desktop でも上記と同じ構成を使用できます。

スタンドアロンの起動

# Run directly from GitHub (no installation needed)
npx -y github:nacgarg/bazel-mcp-server

# From source
git clone https://github.com/nacgarg/bazel-mcp-server.git
cd bazel-mcp-server
npm install
npm run build
dist/index.js

構成

このMCPサーバーでは、いくつかの異なる設定方法が可能です。それらは以下の順序で使用されます。

コマンドライン引数
環境変数
設定ファイル

構成表

CLI引数	環境変数	設定ファイルキー	説明
`--bazel_path`	`MCP_BAZEL_PATH`	`bazel_path`	使用する Bazel バイナリへのパス。
`--workspace_path`	`MCP_WORKSPACE_PATH`	`workspace_path`	使用する Bazel ワークスペースへのパス。
`--workspace_config`	`MCP_WORKSPACE_CONFIG`	`workspace_config`	使用するワークスペースの設定。デフォルトでは、ワークスペースのルートにある`.bazelrc`ファイルが使用されます。
`--log_path`	`MCP_LOG_PATH`	`log_path`	サーバーログを書き込むパス。