spring-ai-mcp-server-demo

🚀 Agentic AI 演示 - 智能业务平台

借助 AI 驱动的自动化，变革您的业务运营！

欢迎体验前沿演示，了解 AI Agent 如何与实际业务应用无缝集成。该平台展示了一个完整的微服务生态系统，AI 助手（如 Claude 或 GitHub Copilot）可以通过自然对话直接管理订单、处理付款和处理事件。

✨ 有何特别之处？

🤖 与业务系统对话：使用自然语言管理订单、付款和事件
⚡ 实时运营：AI Agent 执行实际业务操作，而非处理模拟数据
🔧 可用于生产环境：采用企业级技术和最佳实践构建
🎯 即插即用：使用 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️⃣ 验证服务是否正常运行

打开以下链接，确认服务已启动：

• 🌐 订单管理界面 - 管理客户订单
• 💳 付款门户 - 处理交易
• 🎯 事件仪表板 - 跟踪问题
• 📊 订单 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 实现实时事件处理
• 🧪 测试套件 - 添加全面的集成测试
• 🌍 多租户 - 支持多个组织

📞 支持与贡献

• 🐛 发现了 Bug？ 请提交 issue，并附上详细的复现步骤
• 💡 有想法？ 欢迎分享你的建议
• 🤝 想要贡献？ 请查看我们的贡献指南
• 📚 需要帮助？ 欢迎加入我们的社区讨论