返回 MCP 目录
public公开dns本地运行

gradle-mcp-server

Gradle MCP Server是一个基于Gradle Tooling API的服务,允许AI工具以编程方式与Gradle项目交互,提供项目信息查询、任务执行和测试运行功能。

article

README

🚀 Gradle 服务

该 Gradle 服务以自包含的 JAR 文件形式存在,主要用于与支持 MCP(Machine Comprehension Protocol)协议的客户端进行通信。它借助 Gradle 实现了强大的构建和测试功能,同时支持通过标准输入/输出或 SSE(Server-Sent Events)两种方式进行通信,为开发和使用提供了便利。

✨ 主要特性

  1. 自包含运行:无需进行额外配置,直接在命令行启动服务即可使用。
  2. 协议支持:与 MCP 协议兼容,可与 Anthropic 的 Console Inspector 等工具集成。
  3. 日志记录:内置 Logback,能实现详细的调试和错误日志记录。

🚀 快速开始

下载并运行

  1. 获取预编译的 JAR 文件:
wget https://github.com/gradle/mcp-service/releases/download/v1.0.0/gradle-mcp-server-1.0.0-all.jar
  1. 启动服务(默认使用标准输入输出通信):
java -jar gradle-mcp-server-1.0.0-all.jar

通过 SSE 运行

若需要启用 SSE 服务器模式,指定端口启动:

java -jar gradle-mcp-server-1.0.0-all.jar --sse 3001

此时客户端可通过http://localhost:3001/sse连接。

📦 安装指南

标准配置

  • --stdio:默认模式,使用标准输入输出进行通信。
  • --sse [端口]:启动 SSE 服务器,默认端口为 3001。
  • --debug:启用调试日志输出。

📚 详细文档

开发构建

若需从源码构建:

  1. 克隆仓库:
git clone https://github.com/gradle/mcp-service.git
cd mcp-service
  1. 确保已安装 JDK 17 或更高版本。
  2. 执行构建命令:
./gradlew shadowJar
  1. 构建完成的 JAR 文件将位于build/libs/目录下,格式为gradle-mcp-server-<version>-all.jar

依赖项

  • Gradle 工具链 API(版本由build.gradle.kts指定)
  • Anthropic MCP Kotlin SDK
  • Ktor 框架(用于 SSE 服务器模式)
  • Logback 日志库
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端