mcpField
S
Spring MCP Server Demo

Spring MCP Server Demo

本地服务
github.com/esurovtsev开发工具174 周前更新
代码仓库

关于 Spring MCP Server Demo

Spring MCP Server Demo 是一个使用 Java 和 Spring Boot 构建远程 MCP 服务的示例。它展示工具注册与回调处理，并提供基于 RAG 的文档搜索工具。

主要功能

  1. 01使用 Spring AI 注册 MCP 工具
  2. 02处理工具回调
  3. 03通过 RAG 工具搜索文档
  4. 04使用 Maven 或 Docker 运行

适用场景

  1. 01了解基于 Spring 的 MCP 服务实现
  2. 02通过 MCP 工具测试文档搜索
  3. 03在本地或 Docker 中运行示例

MCP 相关

它使用 Spring AI 和 SSE 实现远程 MCP 服务，公开一个可供 MCP 客户端发现和调用的文档搜索工具。

#spring-mcp#mcp-server#spring-boot

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "spring-mcp-remote-sse": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Spring MCP 服务演示

一个简单的示例，演示如何使用 Spring Boot 和 Java 构建远程 Model Context Protocol（MCP）服务。本项目展示了如何实现并公开可供 AI 模型通过 MCP 协议调用的工具。

包含内容

  • 使用 Spring AI 实现的完整 MCP 服务
  • 工具注册和回调处理
  • 将 RAG 搜索服务作为实用工具示例
  • 支持 Docker，便于部署

快速开始

# Run with Maven
mvn spring-boot:run

# Or build and run the JAR
mvn clean package
java -jar target/mcpserver-0.0.1-SNAPSHOT.jar

服务将在 http://localhost:8080 启动。

🧪 使用 MCP Inspector 测试

MCP Inspector 是一款工具，无需与 LLM 集成即可测试 MCP 服务。

# Run the Inspector with your MCP server
npx @modelcontextprotocol/inspector

这将启动 MCP Inspector Web 界面（通常位于 http://127.0.0.1:6274）。

Docker 支持

想在 Docker 中运行？没问题！

# Build and package everything in one go
./docker-build.sh

# Run the container
docker run -p 8080:8080 mcp-server:latest

就这样！你的 MCP 服务将在 http://localhost:8080 上提供服务。

可用工具

搜索

搜索 RAG 目录中的文档文件。

参数：

  • query：搜索词

返回： 文档中相关文本片段的列表

工作原理

本演示使用 Spring AI 的 MCP 服务功能，公开可供 AI 模型调用的工具。该服务实现了 Model Context Protocol，使 AI 模型能够发现并使用此服务提供的工具。

RAG 搜索工具展示了如何实现实用工具，通过提供对特定信息源的访问来增强 AI 模型的能力。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。