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 文件以獲取詳細信息。

貢獻說明

歡迎貢獻代碼！請隨時提交拉取請求。