AI导哈

MCP集成服务

基于Spring Boot的MCP集成服务器，连接公共数据API和MCP协议的中介层。

  • by constant94-dev
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 constant94-dev/spring-boot-mcp-integration

使用说明

Spring Boot MCP集成

基于Spring Boot的MCP集成服务器，用于连接公共数据API和MCP协议的中间层。

🚀 快速入门

使用集成脚本

# 전체 프로세스 실행 (빌드 + 테스트 + 서버 시작)
./spring-boot.sh all

# 개별 명령 실행
./spring-boot.sh build                 # 프로젝트 빌드
./spring-boot.sh test api              # API 테스트 실행
./spring-boot.sh start background      # 백그라운드에서 서버 시작
./spring-boot.sh logs                  # 로그 파일 목록
./spring-boot.sh help                  # 도움말 표시

运行测试

# API 테스트 (기본값)
./spring-boot.sh test api

# 단위 테스트
./spring-boot.sh test unit

# 전체 테스트
./spring-boot.sh test all

运行服务器

# 포그라운드 실행 (개발 모드)
./spring-boot.sh start foreground

# 백그라운드 실행 (프로덕션 모드)
./spring-boot.sh start background

检查日志

# 로그 파일 목록 확인
./spring-boot.sh logs

# 최신 로그 확인
tail -f logs/spring-boot-*.log

🏗️ 体系结构

模块结构

web/                    # REST API 모듈
├── controller/         # REST API 엔드포인트
├── service/            # 비즈니스 로직
├── dto/               # 데이터 전송 객체
├── config/            # 웹 설정
└── exception/         # 예외 처리

storage/                # 데이터 모듈
├── service/           # Redis 서비스
├── repository/        # JPA Repository
├── entity/            # JPA Entity
├── config/            # Redis/DB 설정
└── cache/             # 캐시 관리

数据流

  1. 接收请求 → 2. 验证 → 3. 验证缓存 → 4. 业务逻辑 → 5. 保存缓存 → 6. 发送响应

🛠️ 技术堆栈

  • Spring Boot: 3.4.0
  • Java: 21
  • 雷迪斯：缓存和保存会话
  • 日本工程标准协会：数据库访问
  • H2/PostgreSQL：数据库
  • Gradle：构建工具
  • Web客户端：HTTP客户端（公共数据API调用）

已完成的工作

  • 使用Spring Boot Initializer创建项目（3.4.0，Java 21）
  • 转换为多模块结构（Web+Storage）
  • 缓存-数据库模式设计（Redis+JPA）
  • 完成依赖性设置（单向：Web→Storage）
  • 消除Thymeleaf依赖性（即将使用Vue.js）
  • 添加CORS支持（准备前端联动）
  • ✅ 完成公共数据门户API集成
  • ✅ 实现XML响应解析
  • ✅ 构建详细的错误处理系统
  • ✅ 完成集成测试和记录系统

📋 下一个任务

排名第一：后端扩展

  • []创建默认实体（User、Session、Log等）
  • []实施JPA Repository
  • []实施Redis服务
  • []连接MCP服务器

第2顺位：设置和测试

  • []设置application.yml
  • []创建单位测试
  • []API联合测试

🏆 近期主要成果（2025-08-24）

已完成公共数据门户API集成

  • API端点: /1613000/RTMSDataSvcAptRent/getRTMSDataSvcAptRent
  • 响应格式：XML解析实现完成
  • 错误处理：详细错误代码和消息处理
  • 测试系统：构建集成测试和记录系统

🔧 实施的核心功能

  • DTO类：7个（请求/响应数据结构）
  • 服务类：2个（API调用和业务逻辑）
  • 控制器：2个（REST API端点）
  • 首选参数：管理基于application.yml的设置
  • 测试：实际API调用验证和统计信息

📈 技术成熟度

  • API集成：完成95%（仅需要实际服务密钥）
  • 错误处理：完成90%
  • 测试范围：完成85%
  • 记录：完成80%

🔗 相关项目

📝 更新历史记录

2025-08-24

  • ✅ 完成公共数据门户API集成
  • ✅ 实现XML响应解析
  • ✅ 构建详细的错误处理系统
  • ✅ 完成集成测试和记录系统
  • ✅ 脚本集成：将6个脚本合并为1个（spring-boot.sh)
  • ✅ 删除PID文件：删除PID文件创建逻辑
  • ✅ 改进日志管理：将日志文件保存到logs文件夹
  • ✅ 改善环境变量管理：基于application.yml集成
  • ✅ 删除不必要的脚本：删除重复的.sh文件
  • ✅ 删除前端文件夹：frontend/删除文件夹

2025-08-17

  • 使用Spring Boot Initializer创建项目（3.4.0，Java 21）
  • 转换为多模块结构（Web+Storage）
  • 缓存-数据库模式设计（Redis+JPA）
  • 完成依赖性设置（单向：Web→Storage）
  • 消除Thymeleaf依赖性（即将使用Vue.js）
  • 添加CORS支持（准备前端联动）

上次更新: 2025-08-24
作者：伊森
状态：公共数据门户API集成完成

相关 MCP