JinDaGe - mcp4ail MCP Details

article

README

🚀 MCP4AIL - 展示MCP服务器开发的系统

MCP4AIL是一个基于Spring Boot构建的贷款信用管理系统，借助Spring AI MCP（模型上下文协议）服务器实现。该系统为金融机构提供了智能信用管理解决方案，用于贷款处理和客户数据管理。

🚀 快速开始

前提条件

Java 17 或更高版本
Maven 3.6.0 或更高版本

运行应用程序

克隆仓库：

git clone [repository-url]
cd mcp4ail

构建项目：

mvn clean install

运行应用程序：

mvn spring-boot:run

访问应用程序：

主应用程序：http://localhost:9081
H2 控制台：http://localhost:9081/h2-console

访问 H2 控制台时，请使用以下连接设置：

驱动类：org.h2.Driver
JDBC URL：jdbc:h2:mem:testdb;MODE=MySQL
用户名：sa
密码：（空）

✨ 主要特性

客户管理：通过唯一标识对客户信息进行全面跟踪。
贷款产品目录：管理各类贷款产品（住房公积金贷款、税务贷款、消费贷款）。
信用额度管理：为客户设置特定的信用额度和可用余额。
合同管理：详细跟踪贷款合同，包括本金和利息计算。
还款计划：自动生成还款计划，并按月细分。
逾期跟踪：全面记录逾期情况，并计算罚款。
H2 控制台：内置数据库管理界面。

📦 安装指南

克隆项目

git clone [repository-url]
cd mcp4ail

构建项目

mvn clean install

运行项目

mvn spring-boot:run

💻 使用示例

基础用法

本系统提供了丰富的 REST API 用于各种业务操作，以下是一些常见操作的示例：

// 假设这里有一个获取客户信息的 API 调用示例
// 代码待补充，根据实际 API 情况完善

📚 详细文档

项目概述

MCP4AIL 是一个采用前沿 Spring 技术构建的金融贷款信用管理系统。它既展示了 Spring AI MCP 的功能，又是一个实用的信用管理平台。该应用程序具有以下特点：

MCP 服务器实现：利用 Spring AI 的模型上下文协议服务器进行人工智能增强的金融操作。
金融数据管理：全面管理客户信息、贷款产品、信用额度、贷款合同、还款计划和逾期记录。
现代技术栈：采用 Spring Boot、MyBatis Plus 和 Spring AI 构建。
数据库集成：使用支持 MySQL 兼容模式的 H2 内存数据库。
Web 界面：使用 Thymeleaf 模板生成动态 Web 内容。

项目结构

src/main/java/com/gientech/agentops/mcp/
├── controller/     # REST API 控制器
├── entity/         # 领域实体
├── mapper/         # MyBatis Plus 映射器接口
├── providers/      # MCP 提供者
├── service/        # 业务逻辑服务
└── Mcp4ailApplication.java

技术栈

| 属性 | 详情 | |------|------| | 核心编程语言 | Java 17 | | 应用框架 | Spring Boot 3.5.6 | | AI 集成框架 | Spring AI（含 MCP 服务器） | | ORM 框架 | MyBatis Plus | | 数据库 | H2 内存数据库（支持持久化模式） | | 模板引擎 | Thymeleaf | | 代码简化库 | Lombok | | 构建和依赖管理工具 | Maven |

MCP 服务器配置

该应用程序实现了 Spring AI 的模型上下文协议服务器，配置如下：

服务器名称：loan-credit-server
版本：1.7.0
协议：STREAMABLE
MCP 端点已配置用于 AI 集成

🔧 技术细节

数据库架构

系统包含以下核心表：

customer：客户信息（姓名、证件类型、证件号码、联系方式）
loan_product：贷款产品定义，包含代码和描述
customer_credit：客户特定的信用额度和可用余额
loan_contract：贷款协议，包含本金和利息计算
repayment_plan：按月细分的还款计划
overdue_record：历史还款记录和罚款计算

示例数据

应用程序附带了全面的示例数据，可用于立即测试：

3 个具有不同身份和联系信息的客户
3 种不同的贷款产品，涵盖消费贷款、税务贷款和住房公积金贷款
多个具有不同额度的信用额度
5 份具有不同条款和余额的贷款合同
2024 年和 2025 年的还款计划
历史和预计的逾期记录

📄 许可证

本项目采用 MIT 许可证，请参阅 LICENSE 文件以获取详细信息。

贡献说明

欢迎贡献代码！请随时提交拉取请求。

mcp4ail