spring-ai-mcp-server-demo

🚀 エージェント型 AI デモ - スマートビジネスプラットフォーム

AI を活用した自動化で、ビジネス業務を変革しましょう！

AI エージェントが実際のビジネスアプリケーションとシームレスに連携する方法を紹介する、最先端のデモへようこそ。このプラットフォームでは、Claude や GitHub Copilot などの AI アシスタントが、自然な会話を通じて注文の管理、決済処理、インシデント対応を直接行える、完全なマイクロサービスエコシステムを紹介します。

✨ このプラットフォームの特長

🤖 ビジネスシステムと会話：自然言語を使って、注文、決済、インシデントを管理できます
⚡ リアルタイムの業務処理：AI エージェントは、モックデータを扱うだけでなく、実際のビジネス業務を実行します
🔧 本番環境にも対応：エンタープライズグレードのテクノロジーとベストプラクティスを採用しています
🎯 すぐに利用可能：Docker で簡単にセットアップでき、数分で起動できます
🌐 モダンな技術スタック：Vue.js フロントエンド、Spring Boot API、インテリジェントな MCP サーバーを採用しています

📋 概要

🏗️ システムアーキテクチャ

    🖥️ Frontend Apps (Vue.js + TypeScript)
    ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
    │   Orders    │  │  Payments   │  │  Incidents  │
    │   :5173     │  │   :5174     │  │   :5175     │
    └─────────────┘  └─────────────┘  └─────────────┘
           │                │               │
    ⚡ REST APIs (Spring Boot + Java)
    ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
    │ Order API   │  │Payment API  │  │Incident API │
    │   :8081     │  │   :8082     │  │   :8083     │
    └─────────────┘  └─────────────┘  └─────────────┘
           │                │               │
           └────────────────┼───────────────┘
                           │
    🤖 AI Integration Layer
           ┌─────────────────────────┐
           │     MCP Servers         │
           │   (AI ↔ Business)       │
           │       :8085             │
           └─────────────────────────┘
                           │
    💾 Data Layer
           ┌─────────────────────────┐
           │      MongoDB            │
           │   (Document Store)      │
           │       :27017            │
           └─────────────────────────┘

🚀 3 分で始めましょう！

前提条件 ✅

• Docker Desktop がインストールされ、起動していること
• 使用可能なポート：5173-5175、8081-8083、8085、27017

1️⃣ すべてを起動

# Navigate to project directory
cd agentic-ai-demo

# 🚀 Start all services (this might take 2-3 minutes first time)
docker-compose up --build -d

# ✅ Check everything is running
docker-compose ps

2️⃣ 動作を確認

以下のリンクを開いて、サービスが起動していることを確認します：

• 🌐 注文管理 UI - 顧客の注文を管理します
• 💳 決済ポータル - 取引を処理します
• 🎯 インシデントダッシュボード - 問題を追跡します
• 📊 注文 API のヘルスチェック - {"status":"UP"} と表示されるはずです

3️⃣ サンプルデータを確認

このプラットフォームには、現実的なビジネスデータがあらかじめ用意されています：

• サンプル注文 8 件（新規 → 処理中 → 発送済み → 配達済みなど、さまざまな段階）
• 決済レコード 4 件（さまざまなステータス）
• インシデントチケット 5 件（さまざまな優先度）

🎉 準備完了です！ ビジネスプラットフォーム全体が起動しました！

🛠️ 管理コマンド

基本的な操作

# 🛑 Stop everything
docker-compose down

# 🔄 Restart a specific service  
docker-compose restart order-backend

# 📜 View logs for debugging
docker-compose logs -f [service-name]

# 🧹 Clean slate (removes all data)
docker-compose down --volumes

# 🗑️ Complete cleanup (removes images too)
docker-compose down --volumes --rmi all

ヘルスモニタリング

すべてのサービスにスマートなヘルスチェックが備わっています：

• ✅ 自動修復：異常なコンテナは自動的に再起動します
• ⏱️ 迅速な検出：問題を 30 秒以内に検出します
• 🔄 再試行ロジック：失敗と判定する前に 3 回試行します

ヘルスステータスを確認：docker-compose ps

🧰 技術スタック

🤖 AI アシスタントを接続する

AI アシスタントを接続すると、会話を通じてビジネス業務を操作できるようになります！

🔧 VS Code のクイックセットアップ

1. MCP サーバーをビルドします（初回のみ）：

# Build both MCP server JAR files
./gradlew :mcp-servers:oms-mcp-server:build
./gradlew :mcp-servers:incident-mcp-server:build

2. VS Code を設定します - settings.json に追加します：

{
  "mcp": {
    "servers": {
      "oms-mcp-server": {
        "type": "stdio",
        "command": "java",
        "args": ["-jar", "YOUR_PROJECT_PATH/mcp-servers/oms-mcp-server/build/libs/oms-mcp-server-0.0.1-SNAPSHOT.jar"]
      },
      "incident-mcp-server": {
        "type": "stdio", 
        "command": "java",
        "args": ["-jar", "YOUR_PROJECT_PATH/mcp-servers/incident-mcp-server/build/libs/incident-mcp-server-0.0.1-SNAPSHOT.jar"]
      }
    }
  },
  "chat.mcp.discovery.enabled": true
}

3. YOUR_PROJECT_PATH を実際のプロジェクトパスに置き換えます。

💬 ビジネスシステムと会話する

接続したら、次のような自然言語のコマンドを試してみてください。

💡 ヒント：AI はビジネスのコンテキスト全体を把握し、操作を検証するため、複雑なビジネスワークフローについても自然に会話できます！

❓ トラブルシューティング

# Check if ports are already in use
lsof -i :5173 -i :8081 -i :8082 -i :8083 -i :8085 -i :27017

# Clean up any existing containers
docker-compose down --volumes
docker system prune -f

# Restart Docker Desktop and try again
docker-compose up --build -d

🎯 次のステップ

このプラットフォームを拡張する準備はできましたか？次のアイデアを参考にしてください。

• 🔐 認証を追加する - ユーザーログインとロールベースのアクセス制御を実装します
• 📧 メール通知 - 注文ステータスの変更時にアラートを送信します
• 📊 分析ダッシュボード - ビジネスインテリジェンスとレポート機能を追加します
• 🔄 イベントストリーミング - リアルタイムイベント用に Apache Kafka を実装します
• 🧪 テストスイート - 包括的な統合テストを追加します
• 🌍 マルチテナント - 複数の組織をサポートします

📞 サポートとコントリビューション

• 🐛 バグを見つけましたか？ 再現手順を詳しく記載して、Issue を作成してください
• 💡 アイデアがありますか？ ご提案をぜひお聞かせください
• 🤝 コントリビューションしたいですか？ コントリビューションガイドラインをご確認ください
• 📚 サポートが必要ですか？ コミュニティのディスカッションにご参加ください