Bazel MCP Server

This project provides a Model Context Protocol (MCP) server that exposes tools for interacting with Bazel projects.

Status: 🚧 Under Active Development 🚧

Features and interfaces may change.

Features

This server currently provides the following tools:

• `build`: Builds a specified Bazel target.
• `deps`: Finds the dependencies of a given Bazel target, with an optional depth parameter.
• `rdeps` (Reverse Dependencies): Finds all Bazel targets that depend on a given target or file path, with an optional depth parameter.
• `sources`: Finds the direct source files associated with a given Bazel target.
• `test`: Runs tests for a specified Bazel target.

Usage with Claude Desktop

This server is designed to be used as a tool provider for applications like the Claude Desktop app.

1. Installation

Install the server using `go install`:

# Ensure your Go environment is set up (GOPATH, GOBIN, etc.)
go install github.com/aaomidi/mcp-bazel@latest

This command compiles and installs the `mcp-bazel` binary. By default, it's placed in your `$GOPATH/bin` directory or `$HOME/go/bin` if `GOPATH` is not set. Make sure this location is in your system's `PATH` or note the full path to the binary for the next step.

2. Configuration

Add the following configuration to your Claude Desktop settings file (`claude_desktop_config.json`). You can usually find this file via the app's settings menu ("Open Config Folder").

Modify the `"command"` path to point to the actual location where `go install` placed the `mcp-bazel` binary on your system.

{
  "mcpServers": {
    "mcp-bazel": {
      "command": "/path/to/your/go/bin/mcp-bazel"
    }
  }
}

3. Restart Claude Desktop

After saving the configuration file, restart the Claude Desktop app. The Bazel tools should now be available.