MCP-CRUD-Interview-Question

MCP-CRUD-Interview-Question

一个基于 Spring Boot 的模型控制协议（MCP）服务，旨在管理面试题数据库。本项目利用 Spring AI 的 MCP 能力，通过工具提供对面试题数据的访问。

概述

本项目是一个使用 Spring Boot 和 Spring AI 构建的 MCP（模型控制协议）服务。它通过基于工具的交互提供面试题管理服务，方便从数据库中检索、创建、更新和删除面试题。

功能

• 面试题管理：创建、读取、更新和删除面试题
• 按类别筛选：按指定类别检索题目
• 基于工具的 API：使用 Spring AI 的工具注解，便于集成
• MySQL 数据库集成：持久化保存面试题

项目结构

src/
├── main/
│   ├── java/
│   │   └── io/
│   │       └── michaeljgkopp/
│   │           └── github/
│   │               ├── dao/
│   │               │   └── InterviewQuestionRepository.java
│   │               ├── entity/
│   │               │   └── InterviewQuestion.java
│   │               ├── service/
│   │               │   └── InterviewQuestionService.java
│   │               └── SpringMcpServerApplication.java
│   └── resources/
│       ├── application.properties
│       └── create_db.sql

要求

• Java 24
• MySQL 数据库
• Maven 3.6+ 或兼容的构建工具

安装

克隆仓库

git clone https://github.com/MichaelJGKopp/MCP-CRUD-Interview-Question.git
cd MCP-CRUD-Interview-Question

数据库设置

1. 创建所需的 MySQL 数据库：

CREATE DATABASE IF NOT EXISTS mcp_interview_questions_db;

2. 配置具有适当权限的 MySQL 用户（或使用已拥有相应访问权限的现有凭据）

配置

应用通过 application.properties 进行配置。你可以自定义这些设置，或使用环境变量覆盖：

spring.application.name=interview-questions-mcp-server
spring.main.web-application-type=none
spring.ai.mcp.server.name=interview-questions-mcp-server
spring.ai.mcp.server.version=0.0.1

server.port=${SERVER_PORT:3001}

spring.jpa.hibernate.ddl-auto=update

spring.datasource.url=${DB_URL:jdbc:mysql://localhost:3306/mcp_interview_questions_db}
spring.datasource.username=${DB_USERNAME:springstudent}
spring.datasource.password=${DB_PASSWORD:springstudent}

构建项目

mvn clean package

运行服务

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

或者使用自定义环境变量：

SERVER_PORT=3002 DB_USERNAME=custom_user DB_PASSWORD=secure_password java -jar target/spring-mcp-server-0.0.1-SNAPSHOT.jar

可用工具

MCP 服务提供以下工具供交互使用：

工具名称	描述
iqs_get_interview_questions_by_category	检索按指定类别筛选的面试题
iqs_get_interview_questions_all	检索数据库中的所有面试题
iqs_save_interview_question	创建新的面试题或更新现有面试题
iqs_delete_interview_question_by_id	根据 ID 删除面试题
iqs_delete_all_interview_questions	删除所有面试题（请谨慎使用）

面试题模型

每道面试题包含以下字段：

字段	描述
id	唯一标识符（自动生成）
difficulty	题目难度级别（最多 10 个字符）
category	题目类别（例如，“Java”“SQL”“Spring”）
title	题目的简短标题
question	面试题内容（最多 1000 个字符）
answer	答案或解决方案（最多 10000 个字符）

与 AI 模型集成

本 MCP 服务旨在与 Spring AI 配合使用，让 AI 模型通过提供的工具与面试题数据库交互。根据配置中的 spring.main.web-application-type=none，此服务不提供传统的 Web 界面。

开发

添加新类别

系统支持任意字符串类别。要在新类别中添加题目，只需在创建题目时使用该类别名称。

扩展模型

要为 InterviewQuestion 模型添加字段：

1. 更新 InterviewQuestion.java 实体类
2. 添加适当的 getter 和 setter
3. 重启应用（由于设置了 spring.jpa.hibernate.ddl-auto=update，数据库架构会自动更新）

许可证

本项目为开源项目。有关许可证的详细信息，请联系仓库所有者。

联系方式

如有问题或需要支持，请联系 Michael J.G. Kopp。