使用说明

项目简介

Bazel MCP服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型（LLM）客户端提供与Bazel构建系统集成的能力。通过此服务器，LLM客户端可以调用预定义的工具，执行Bazel命令，从而实现代码构建、依赖分析、源码查询和测试等功能。这使得LLM能够更好地理解和操作基于Bazel构建的项目。

主要功能点

构建 (build): 构建指定的Bazel目标。
依赖查询 (deps): 查找给定Bazel目标的依赖项，并可指定依赖深度。
反向依赖查询 (rdeps): 查找依赖于给定Bazel目标或文件路径的所有Bazel目标，并可指定依赖深度。
源码查找 (sources): 查找与给定Bazel目标关联的直接源文件。
测试 (test): 运行指定Bazel目标的测试。

安装步骤

安装 Go 环境: 确保您的系统已安装 Go 语言环境并正确配置 'GOPATH' 和 'GOBIN' 环境变量。
安装 Bazel MCP 服务器: 打开终端，运行以下命令安装 'mcp-bazel' 服务器：
```
go install github.com/aaomidi/mcp-bazel@latest
```
安装成功后，'mcp-bazel' 可执行文件通常会位于 '$GOPATH/bin' 或 '$HOME/go/bin' 目录下。请确保该目录已添加到您的系统 'PATH' 环境变量中，或者记录下完整路径。

服务器配置

要将 Bazel MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器配置信息。以 Claude Desktop 为例，您需要编辑 'claude_desktop_config.json' 文件（通常可以通过 Claude Desktop 应用的设置菜单找到 "Open Config Folder" 选项来打开配置文件所在目录）。

在 'claude_desktop_config.json' 文件中，添加或修改 '"mcpServers"' 部分，配置 'mcp-bazel' 服务器。请将 '"command"' 字段的值替换为您实际的 'mcp-bazel' 可执行文件路径。

{
  "mcpServers": {
    "mcp-bazel": {
      "command": "/path/to/your/go/bin/mcp-bazel"
      // "command": "mcp-bazel"  如果您已将 $GOPATH/bin 或 $HOME/go/bin 添加到系统 PATH，则可以直接使用命令名
    }
  }
}

配置参数说明:

server name (mcp-bazel): 服务器名称，在客户端配置中用于标识该服务器。
command: Bazel MCP 服务器的启动命令。需要指向 'mcp-bazel' 可执行文件的完整路径，或者确保该命令在系统的 PATH 环境变量中。

基本使用方法

配置完成后，重启 MCP 客户端（如 Claude Desktop）。客户端将自动连接到 Bazel MCP 服务器。您可以通过客户端的界面或指令，调用 Bazel MCP 服务器提供的工具，例如：

在客户端中选择或指定 "build" 工具，并提供 Bazel 目标 (target) 和项目路径 (project_path) 参数，即可执行 Bazel 构建命令。
使用 "deps" 工具查询目标的依赖关系，或使用 "rdeps" 工具查询反向依赖关系。
利用 "sources" 工具查找指定目标的源码文件。
调用 "test" 工具运行 Bazel 测试。

具体工具的使用方法和参数，请参考 MCP 客户端的文档或界面说明。

关键词