MCP Server Demo Kut

基于Spring Boot的MCP服务示例项目，集成AI工具链实现数字运算和天气查询功能

开发者工具人工智能聊天机器人 #智能服务 #数值运算 #天气查询 #Spring集成 .Java

评分 : 2.5分

下载量 : 9.5K

更新时间 : 2025-04-23

打开站点

什么是MCP Server Demo?

MCP Server Demo是一个展示Model Control Protocol(MCP)功能的示例项目，它通过简单的API提供数字计算和天气查询服务。项目集成了Spring AI工具链，使开发者能快速了解如何构建智能服务。

如何使用MCP Server Demo?

您可以通过两种方式使用该服务：1) 通过标准输入输出(STDIO)模式与支持MCP的客户端交互；2) 通过SSE(Server-Sent Events)模式访问HTTP端点。

适用场景

适用于需要快速验证MCP协议功能的场景，或作为开发智能服务的入门示例。也可用于教学演示如何将传统服务转换为AI工具。

主要功能

数字服务

提供数字运算功能，包括素数检测、奇偶数判断等基础数学运算

天气服务

提供天气查询功能(当前为模拟数据，可对接真实天气API)

MCP工具支持

通过注解方式轻松将服务方法暴露为标准化工具

优势

开箱即用的MCP协议实现示例

清晰的代码结构便于学习和扩展

支持多种交互模式(STDIO/SSE)

集成Spring AI工具链，便于扩展智能功能

局限性

天气服务目前仅为模拟数据

功能相对基础，适合演示而非生产环境

需要Java 17及以上运行环境

如何使用

获取项目

克隆或下载项目代码到本地

构建项目

使用Maven构建项目

运行服务

选择运行模式并启动服务

连接客户端

使用支持MCP协议的客户端(如Cherry Studio)连接服务

使用案例

检查数字是否为素数

使用数字服务验证一个数字是否为素数

查询天气

查询指定城市的天气情况(当前为模拟数据)

常见问题

运行项目需要什么环境?

如何扩展新的服务功能?

如何对接真实的天气API?

🚀 MCP 服务器演示项目文档

本项目是一个基于 Spring Boot 3.4.4 的 MCP（模型控制协议）服务示例项目，集成了 Spring AI 工具链，可实现智能服务功能。项目中包含基础数值运算、天气查询等服务的实现模板，为开发者提供了便利。

✨ 主要特性

1. 数字服务（`NumberService`）

可进行奇偶数判断。
已实现素数检测功能。
扩展建议：可添加质因数分解、斐波那契计算等功能。

2. 天气服务（`WeatherService`）

提供天气数据接口，当前使用随机数伪代码实现。实际应用时需对接第三方 API，可参考 OpenWeatherMap API。

3. MCP 工具支持

利用 @Tool 注解将服务暴露为标准化工具。
借助 @ToolParam 注解定义服务参数。

📦 安装指南

环境要求

JDK 17
Maven 3.8+
IDE（推荐 IntelliJ IDEA）

运行步骤

1. 克隆仓库

git clone https://github.com/liqingdong/mcp-server-demo.git

2. 构建项目

mvn clean install

3. 使用服务

3.1 使用 STDIO 模式

3.1.1 配置启动命令

java -jar -Dspring.ai.mcp.server.stdio=true target/mcp-server-demo-0.0.1-SNAPSHOT.jar

3.1.2 使用支持 MCP 工具的客户端，例如：Cherry Studio 进行测试

3.2 使用 SSE 模式

3.2.1 配置启动命令（默认访问地址为：http://localhost:8081/sse）

java -jar target/mcp-server-demo-0.0.1-SNAPSHOT.jar

📚 详细文档

项目结构

src
|-- main
|  |-- java
|  |  `-- cn
|  |    `-- liqingdong
|  |      `-- mcp
|  |        `-- server
|  |          |-- McpApplication.java
|  |          `-- service
|  |            |-- NumberService.java
|  |            `-- WeatherService.java
|  `-- resources
|    `-- application.yml
`-- test
  `-- java
    `-- cn
      `-- liqingdong
        `-- mcp
          `-- server
            |-- McpApplicationTest.java
            `-- SSEMcpTest.java
            `-- STDIOMcpTest.java