local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Exposes Bazel build system functionality, allowing for building targets, querying dependency graphs, running tests, listing available targets, fetching external dependencies, and setting the workspace path at runtime.
Bazel MCP 服务器
本地 MCP 服务器向支持 MCP 的 AI 代理公开Bazel构建系统的功能。
当 MCP 环境没有现有的命令行工具，或者调用的 shell 的环境配置错误导致无法使用 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/mcp.json 。
您不需要提供工作区路径，因为 LLM 可以使用set_workspace_path在运行时更改工作区路径。
bazel 二进制文件通常会被自动拾取，但如果遇到问题，您可以使用--bazel_path标志提供 bazel 二进制文件的路径。
:warning: 请注意，当使用 Cursor 和远程 SSH 会话时这将不起作用，因为它在本地运行 MCP 服务器。
与 Claude Desktop 一起使用
您可以在 Claude Desktop 中使用与上述相同的配置。
启动独立
配置
此 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 | 写入服务器日志的路径。 |
调试
设置DEBUG=true环境变量以启用详细日志记录到控制台。
设置日志路径也有助于调试不将日志打印到控制台的客户端（看着你，Cursor）。
执照
本项目遵循 MIT 许可证。详情请参阅LICENSE文件。
This server cannot be installed
本地 MCP 服务器向 AI 代理公开 Bazel 构建系统功能，允许它们即使在无法直接访问 Bazel 的环境中也能通过自然语言构建、测试、查询和管理 Bazel 项目。