学生信息查询服务

基于Spring Boot和Spring AI框架开发的MCP服务器,提供学生基本信息和成绩查询功能,适用于AI助手和自动化工具集成。

  • by asxhomrina-creator
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 asxhomrina-creator/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 <repository-url>
  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 将服务方法注册为工具。

参考资源