Solar MCP Serer 251018

Solar MCP Server 3

项目简介

Solar MCP Server 3 是一个基于Spring Boot和Spring AI框架开发的Model Context Protocol (MCP)服务器。该项目提供了学生信息查询功能，通过MCP协议对外提供服务接口，可用于集成AI助手和自动化工具。

技术栈

• Java 17
• Spring Boot 3.5.6
• Spring AI 1.0.3
• Spring AI MCP Server WebMVC 1.1.0-M1
• Lombok
• Maven

功能特性

• 通过MCP协议提供学生信息查询服务
• 支持查询学生基本信息
• 支持查询学生成绩信息

快速开始

环境要求

• JDK 17或更高版本
• Maven 3.6或更高版本

安装与运行

1. 克隆项目到本地：

git clone 

1. 进入项目目录：

cd solar-mcp-serer3

1. 使用Maven构建并运行项目：

mvn clean install
mvn spring-boot:run

或者，如果您使用的是Windows系统，可以直接运行：

./mvnw spring-boot:run

API文档

提供的工具

getStudentInfoByName

• 描述: 获取学生基本信息
• 参数: name (学生姓名)
• 返回: 学生基本信息字符串，包含年龄和身高等信息

getStudentScoreByName

• 描述: 获取学生的成绩
• 参数: name (学生姓名)
• 返回: 学生成绩信息字符串

项目结构

src/main/java/com/example/solarmcpserer3/
├── SolarMcpSerer3Application.java      # 主应用程序入口
├── config/
│   └── McpServerConfig.java            # MCP服务器配置
└── service/
    ├── IStudentService.java            # 学生服务接口
    └── impl/
        └── StudentServiceImpl.java     # 学生服务实现

开发指南

添加新功能

要添加新的工具功能，您需要：

1. 在 IStudentService 接口中定义新的方法
2. 在 StudentServiceImpl 实现类中实现该方法，并添加 @Tool 注解
3. 确保方法参数使用 @ToolParam 注解进行描述

MCP协议配置

MCP服务器的配置在 McpServerConfig 类中完成，通过 MethodToolCallbackProvider 将服务方法注册为工具。

参考资源

• Spring Boot官方文档
• Spring AI文档
• Model Context Protocol (MCP)文档