SpringBoot端点自动暴露工具

SpringBoot-MCP是一个零配置工具,用于自动将Spring Boot端点暴露为模型上下文协议(MCP)工具,适用于需要快速集成MCP的Spring Boot应用开发场景。

  • by imthath-m
  • Java
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 imthath-m/rest-mcp-server

使用说明

SpringBoot MCP

一个零配置工具,用于自动将Spring Boot端点公开为模型上下文协议(MCP)工具。

特性

  • 直接积分法 -无需配置即可将MCP服务器直接安装到Spring Boot应用程序
  • 自动发现 所有Spring REST端点和转换为MCP工具
  • 保留架构 您的请求和响应模型

安装

将依赖项添加到Maven中 pom.xml:

<dependency>
    <groupId>com.github.imthath-m</groupId>
    <artifactId>rest-mcp-server</artifactId>
    <version>0.2.1</version>
</dependency>

目前,SpringBoot MCP在Maven中央存储库上不可用。因此,您必须添加以下呼吸剂 pom.xml,以确保JitPack直接从GitHub提供服务。

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

基本用法

添加依赖关系后,您需要从您的 pom.xml 文件。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

此步骤是必需的,因为此包依赖于 spring-ai-starter-mcp-server-webflux 它已经完成了Netty服务器的基本设置。

就是这样!您的自动生成MCP服务器现在可以在 https://localhost:8080/sse。您可以使用指定的变量配置MCP服务器的此功能和其他功能 这里.

运行应用程序后,您应该会看到以下行您的控制台。

o.s.a.m.s.a.McpServerAutoConfiguration   : Registered tools: <number of endpoints>, notification: true

仅供参考,您服务中的REST端点将继续在各自的路径中可用。

工具命名

SpringBoot MCP使用REST控制器中的方法名称作为MCP工具名称。

连接到MCP服务器

运行带有MCP集成的Spring Boot应用程序后,您可以使用任何支持SSE或stdio协议的MCP客户端连接到它。

使用SSE(例如,使用游标)

  1. 运行Spring Boot应用程序
  2. 在光标->设置->MCP->添加新的MCP服务器中,使用URL http://localhost:8080/sse 作为SSE端点
  3. Cursor将自动发现所有可用工具

名为的游标配置文件示例 mcp.json.

{
    "mcpServers": {
      "server-name": {
        "url": "http://localhost:8080/sse"
      }
    }
}

发展与贡献

欢迎投稿!请随时提交拉取请求。

需求

  • Java 21或更高版本
  • 弹簧靴3.x

许可证

MIT许可证。版权所有(c)2025。穆罕默德·伊姆塔胡拉。