Mcp4ail

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

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

🚀 快速开始

前提条件

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

运行应用程序

1. 克隆仓库：

git clone [repository-url]
cd mcp4ail

2. 构建项目：

mvn clean install

3. 运行应用程序：

mvn spring-boot:run

4. 访问应用程序：

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

5. 访问 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

技术栈

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 文件以获取详细信息。

贡献说明

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