Mcp4ail

🚀 MCP4AIL - MCPサーバー開発のデモンストレーションシステム

このシステムは、Spring AI MCP（Model Context Protocol）サーバーを使用したローン信用管理システムを実装するSpring Bootアプリケーションです。金融機関に対して、ローン処理と顧客データ管理のためのインテリジェントな信用管理ソリューションを提供します。

🚀 クイックスタート

前提条件

• 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コンソール: 組み込みのデータベース管理インターフェース

📦 インストール

このアプリケーションは、application.propertiesを介して構成されます。以下の設定が含まれています。

• サーバーがポート9081で実行されます。
• MCPサーバー名は'loan-credit-server'です。
• H2データベースのコンソールが/h2-consoleで有効になっています。
• データベーススキーマとサンプルデータの初期化が行われます。

📚 ドキュメント

概要

MCP4AILは、最新のSpring技術を用いて構築された金融ローン信用管理システムです。Spring AI MCPの機能のデモンストレーションとして機能すると同時に、機能的な信用管理プラットフォームとしても役立ちます。このアプリケーションの特徴は以下の通りです。

• MCPサーバーの実装: AI強化された金融業務のためにSpring AIのModel Context Protocolサーバーを活用します。
• 金融データ管理: 顧客情報、ローン商品、与信枠、ローン契約、返済スケジュール、延滞記録の包括的な管理。
• 最新のテクノロジースタック: Spring Boot、MyBatis Plus、Spring AIを使用して構築されています。
• データベース統合: MySQL互換モードのH2インメモリデータベースを使用します。
• Webインターフェース: 動的なWebコンテンツのためのThymeleafテンプレートを使用しています。

プロジェクト構造

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 - アプリケーションフレームワーク
• Spring AI - MCPサーバーを備えたAI統合フレームワーク
• MyBatis Plus - 高度なORMフレームワーク
• H2 Database - 永続的なスキーマを持つインメモリデータベース
• Thymeleaf - サーバーサイドJavaテンプレートエンジン
• Lombok - コード削減ライブラリ
• Maven - ビルドと依存関係管理

データベーススキーマ

このシステムには、以下のコアテーブルが含まれています。

• customer: 顧客情報（名前、IDタイプ、ID番号、連絡先詳細）
• loan_product: コードと説明を持つローン商品の定義
• customer_credit: 顧客固有の与信限度額と利用可能性
• loan_contract: 金額、日付、ステータスを含むローン契約
• repayment_plan: 利息/元本の内訳付きの月次返済予定
• overdue_record: 支払いと罰金の履歴記録

サンプルデータ

このアプリケーションには、即時テスト用の包括的なサンプルデータが同梱されています。

• 様々な識別情報と連絡先情報を持つ3人の顧客
• 消費者ローン、税金ローン、住宅公積金ローンをカバーする3種類の異なるローン商品
• 様々な限度額を持つ複数の与信枠
• 異なる条件と残高を持つ5つのローン契約
• 2024年と2025年の返済スケジュール
• 過去と予測される延滞記録

MCPサーバー設定

このアプリケーションは、Spring AIのModel Context Protocolサーバーを以下の設定で実装しています。

• サーバー名: loan-credit-server
• バージョン: 1.7.0
• プロトコル: STREAMABLE
• MCPエンドポイントはAI統合のために構成されています。

🔧 技術詳細

MCP4AILは、Spring Boot、MyBatis Plus、Spring AIなどの最新のSpring技術を活用して構築された金融ローン信用管理システムです。このシステムは、AI強化された金融業務を可能にするためにSpring AIのModel Context Protocolサーバーを使用しています。データベースとしては、MySQL互換モードのH2インメモリデータベースを使用しており、Thymeleafを用いた動的なWebインターフェースを提供します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

貢献

貢献は歓迎されます！プルリクエストを送信してください。