使用说明

项目简介

Spring IO API MCP Server 是一个基于 Spring AI MCP 框架构建的服务器应用,旨在为 LLM 应用提供访问 Spring 官方项目信息的接口。它通过工具 (Tools) 的形式,向客户端暴露 Spring 项目的版本发布信息、支持周期信息以及未来发布计划,使得 LLM 能够理解和利用最新的 Spring 生态数据。

主要功能点

  • Spring 项目版本信息查询: 提供工具查询指定 Spring 项目已发布的版本列表及其详细信息。
  • Spring 项目支持周期查询: 提供工具查询指定 Spring 项目不同版本的支持周期,包括开源支持结束日期和商业支持结束日期。
  • Spring 项目未来发布计划查询: 提供工具查询未来90天内 Spring 项目的发布计划。
  • 基于 Stdio 传输协议: 使用标准的 Stdio (标准输入输出) 作为 MCP 服务器的传输协议,易于集成和部署。

安装步骤

  1. 克隆仓库:将 GitHub 仓库克隆到本地。
  2. 构建项目:在项目根目录下,执行以下 Maven 命令进行构建:
    ./mvnw clean package
    构建成功后,将在 'target' 目录下生成 JAR 文件 'spring-io-api-mcp-0.0.1-SNAPSHOT.jar'。

服务器配置

要让 MCP 客户端连接到此服务器,需要在客户端配置中添加服务器启动命令和参数。以下是 Cline (VSCode 插件) 的配置示例,其他 MCP 客户端的配置方式类似:

{
  "spring-project-information": {  // 服务器名称,可以自定义
    "command": "java",  // 启动服务器的命令,这里使用 java
    "args": [  // 命令参数
      "-Dtransport.mode=stdio",  // 设置 MCP 传输模式为 Stdio
      "-Dspring.main.web-application-type=none",  // 禁用 Spring Boot 的 Web 应用特性,以命令行应用方式运行
      "-Dlogging.file.name=/spring-io-api-mcp.log",  // (可选) 设置日志文件路径和名称
      "-jar",  //  指定运行可执行 JAR 文件
      "<path-to-project>/target/spring-io-api-mcp-0.0.1-SNAPSHOT.jar"  //  **请替换为实际的 JAR 文件路径**,即上一步构建生成的 JAR 文件路径
    ]
  }
}

基本使用方法

  1. 启动服务器:在 MCP 客户端中配置并启动名为 "spring-project-information" (或自定义名称) 的服务器。客户端会根据配置的命令和参数启动 MCP 服务器。
  2. 在 Prompt 中提问:在 LLM 客户端的 Prompt 中,可以使用自然语言提问关于 Spring 项目的信息。服务器将通过工具调用 Spring 官方 API 获取数据,并返回给 LLM 客户端。例如:
    • "spring-boot 项目有哪些已发布版本?"
    • "spring-boot 项目最新发布的版本是什么?"
    • "spring-boot 最新版本在开源社区的支持到什么时候结束?"
    • "spring-data-core 项目在未来 90 天内有更新的版本发布吗?"

信息

分类

网页与API