Gradle MCP 服务器

一个用于 Gradle 的模型上下文协议（MCP）服务器。它为 AI 智能体提供了探索项目结构、运行任务、审计依赖项以及与 JVM 运行时交互所需的工具。

功能

源代码下载和索引工具将很快迁移到专用的 MCP/cli。

智能体技能：内置的工作流，引导 AI 智能体完成复杂的 Gradle 任务。
项目映射：轻松探索多项目结构、模块、任务和属性。
智能任务执行：在后台运行构建，监控进度，并捕获特定任务的输出，避免噪音。支持高级环境控制和 shell 环境源加载。
高级测试：运行过滤后的测试套件，并获取每个测试用例的完整日志和堆栈跟踪。
依赖项与源代码搜索：搜索和浏览依赖项、JDK 标准库以及 Gradle 源代码。
交互式 Kotlin REPL：在具有所有类访问权限的持久化 REPL 中测试项目实用程序并探索 API。
Compose UI 预览：直接从项目运行时将 UI 组件渲染为图像，以便进行视觉审计。
Gradle 文档：即时访问可搜索、已索引的 Gradle 用户指南和 DSL 参考。
Develocity 构建扫描：让您的智能体发布构建扫描，以便进行深入故障排除。
令牌优化：紧凑的数据格式，旨在保持上下文使用量较低。

配置

GRADLE_MCP_PROJECT_ROOT 环境变量可以在工具调用省略 projectRoot 时提供默认的 Gradle 项目根目录。

入门指南

[!IMPORTANT] 运行 gradle-mcp 需要 JDK 21 或更高版本。你也可以使用 JBang 来安装 JDK：docs.

使用 jbang:

# For releases
jbang run --quiet --fresh gradle-mcp@rnett

# For snapshots
jbang run --quiet --fresh gradle-mcp-snapshot@rnett

{
  "mcpServers": {
    "gradle": {
      "command": "jbang",
      "args": [
        "run",
        "--quiet",
        "--fresh",
        "gradle-mcp@rnett"
      ]
    }
  }
}

或者，直接运行 GAV：

jbang run --fresh dev.rnett.gradle-mcp:gradle-mcp:+

{
  "mcpServers": {
    "gradle": {
      "command": "jbang",
      "args": [
        "run",
        "--fresh",
        "dev.rnett.gradle-mcp:gradle-mcp:+"
      ]
    }
  }
}

[!TIP] 如果遇到与 CDS (Class Data Sharing) 相关的错误，通常是由安全软件（例如 SentinelOne）的原生 JVMTI 代理引起的，您可以通过在 jbang 命令中添加 --no-cds 来禁用它。有关更多详细信息，请参阅 documentation。

Agent Skills

Agent Skills 是专门指南，帮助 AI 代理可靠地导航常见的 Gradle 工作流。

包含的技能：

using-gradle: 检查、运行和诊断现有的 Gradle 构建 — 项目映射、测试诊断、依赖项审计和源代码研究。
authoring-gradle-builds: 修改构建定义、连接和项目结构 — 依赖项声明、模块创建、工具链配置和最佳实践。
advanced-gradle-dependencies: 诊断和解决涉及变体、功能、验证和仓库治理的复杂依赖项问题。
interacting-with-project-runtime: 使用具有完整类路径访问权限的持久化 Kotlin REPL 实时执行和验证项目逻辑。
verifying-compose-ui: 通过将 Compose UI 组件从项目运行时渲染为图像，直观地审计这些组件。

有关如何使用这些技能的说明，请参阅 Agent Skills 文档。