弹簧人工智能MCP服务器示例
项目介绍
🚀 Agentic AI Demo - 智能商务平台
利用AI驱动的自动化来革新您的业务运营！
欢迎来到一个前沿演示，展示如何将AI代理无缝集成到实际的业务应用中。该平台展示了完整的微服务生态系统，其中AI助手（如Claude或GitHub Copilot）可以通过自然对话直接管理订单、处理支付并应对事件。
✨ 特色亮点
🤖 与您的业务系统对话：使用自然语言来管理订单、支付和事件
⚡ 实时操作：AI代理执行实际的业务操作，而不仅仅是模拟数据
🔧 生产就绪：采用企业级技术和最佳实践构建
🎯 即插即用：通过Docker轻松设置，在几分钟内即可运行
🌐 现代技术栈：Vue.js前端、Spring Boot API 和智能MCP服务器
📋 快速概览
| 服务 | 功能 | 前端 | API |
|---|---|---|---|
| 📦 订单 | 管理客户订单及生命周期 | localhost:5173 | localhost:8081 |
| 💳 支付 | 处理支付及交易 | localhost:5174 | localhost:8082 |
| 🚨 事件 | 跟踪问题及解决方案 | localhost:5175 | localhost:8083 |
| 🧠 AI助手 | 智能自动化层 | - | localhost:8085 |
🏗️ 系统架构
🖥️ 前端应用 (Vue.js + TypeScript)
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 订单 │ │ 支付 │ │ 事件 │
│ :5173 │ │ :5174 │ │ :5175 │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
⚡ REST API (Spring Boot + Java)
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 订单API │ │支付API │ │事件API │
│ :8081 │ │ :8082 │ │ :8083 │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
└────────────────┼───────────────┘
│
🤖 AI集成层
┌─────────────────────────┐
│ MCP服务器 │
│ (AI ↔ 业务) │
│ :8085 │
└─────────────────────────┘
│
💾 数据层
┌─────────────────────────┐
│ MongoDB │
│ (文档存储) │
│ :27017 │
└─────────────────────────┘
🚀 三分钟快速入门！
先决条件 ✅
- 安装并运行Docker Desktop
- 可用端口：
5173-5175,8081-8083,8085,27017
1️⃣ 启动所有服务
# 导航至项目目录
cd agentic-ai-demo
# 🚀 启动所有服务（首次可能需要2-3分钟）
docker-compose up --build -d
# ✅ 检查所有服务是否运行
docker-compose ps
2️⃣ 验证是否正常工作
打开以下链接确认服务已启动：
3️⃣ 探索示例数据
平台预加载了真实的业务数据：
- 8个示例订单处于不同阶段（新订单 → 处理中 → 已发货 → 已送达）
- 4笔支付记录具有不同的状态
- 5张事件工单具有不同的优先级
🎉 准备好了！ 您的完整业务平台现在正在运行！
🛠️ 管理命令
基本操作
# 🛑 停止所有服务
docker-compose down
# 🔄 重启特定服务
docker-compose restart order-backend
# 📜 查看日志以进行调试
docker-compose logs -f [服务名]
# 🧹 清空数据（删除所有数据）
docker-compose down --volumes
# 🗑️ 完全清理（删除镜像）
docker-compose down --volumes --rmi all
健康监控
所有服务都包含智能健康检查：
- ✅ 自动恢复：不健康的容器会自动重启
- ⏱️ 快速检测：在30秒内检测到问题
- 🔄 重试逻辑：失败前尝试3次
检查健康状态：docker-compose ps
🧰 技术栈
<details> <summary><strong>🖥️ 前端技术</strong></summary>- Vue.js 3 - 现代响应式框架，支持组合API
- TypeScript - 类型安全开发，具有优秀的IDE支持
- Vite - 雷霆般的构建工具和热重载
- CSS3 - 现代样式设计，支持响应式布局
- Spring Boot - 企业级Java框架，支持自动配置
- H2数据库 - 内嵌SQL数据库，适合快速开发
- MongoDB - 文档数据库，支持灵活的数据结构
- Gradle - 高级构建自动化和依赖管理
- Docker - 容器化，确保环境一致性
- Docker Compose - 多容器编排
- 健康检查 - 内置监控和自动恢复
- 多阶段构建 - 优化容器镜像
- 模型上下文协议 (MCP) - AI应用集成的标准
- REST API - 基于HTTP的服务通信
- Spring Boot Actuator - 生产监控端点
🤖 连接您的AI助手
真正的魔法发生在您连接AI助手并通过对话控制您的业务操作时！
🔧 快速设置VS Code
- 构建MCP服务器（一次性设置）：
# 构建两个MCP服务器JAR文件
./gradlew :mcp-servers:oms-mcp-server:build
./gradlew :mcp-servers:incident-mcp-server:build
- 配置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
}
- **替换
YOUR_PROJECT_PATH**为您的实际项目路径。
💬 与您的业务系统对话
一旦连接，您可以尝试这些自然语言命令：
| 您说什么 | 发生什么 |
|---|---|
| "显示所有待处理订单" | 📋 列出等待处理的订单 |
| "创建订单#1001的150美元支付" | 💳 处理新的支付交易 |
| "有哪些高优先级事件是开放的？" | 🚨 过滤需要关注的关键问题 |
| "将订单#1001推进到下一阶段" | ⚡ 将订单推进到工作流的下一个阶段 |
| "显示所有失败的支付" | 💸 显示需要重试的交易 |
💡 小贴士：AI助手维护完整的业务上下文并验证操作，因此您可以就复杂的业务流程进行自然对话！
❓ 故障排除
<details> <summary><strong>🚨 服务无法启动</strong></summary>问题：docker-compose up失败或服务显示为不健康
解决方法：
# 检查端口是否已被占用
lsof -i :5173 -i :8081 -i :8082 -i :8083 -i :8085 -i :27017
# 清理任何现有的容器
docker-compose down --volumes
docker system prune -f
# 重新启动Docker Desktop并再次尝试
docker-compose up --build -d
问题：MCP服务器未被VS Code或Claude识别
解决方法：
-
验证JAR文件是否存在：
ls -la mcp-servers/*/build/libs/*.jar -
如果缺失则重新构建：
./gradlew :mcp-servers:oms-mcp-server:build ./gradlew :mcp-servers:incident-mcp-server:build -
检查VS Code设置路径 - 在settings.json中使用绝对路径
-
更改配置后重启VS Code
问题：示例数据在重启后消失
解决方法：这是预期的行为。H2数据库用于演示目的，是在内存中的。MongoDB数据在Docker卷中持久化。
</details>🎯 下一步是什么？
准备好扩展此平台了吗？这里有一些想法：
- 🔐 添加认证 - 实现用户登录和基于角色的访问
- 📧 电子邮件通知 - 发送订单状态变化的警报
- 📊 分析仪表板 - 添加商业智能和报告
- 🔄 事件流 - 实现Apache Kafka进行实时事件处理
- 🧪 测试套件 - 添加全面的集成测试
- 🌍 多租户 - 支持多个组织
📞 支持与贡献
- 🐛 发现了一个bug？ 打开一个详细描述复现步骤的问题
- 💡 有想法？ 我们很乐意听取您的建议
- 🤝 想贡献吗？ 查看我们的贡献指南
- 📚 需要帮助？ 加入我们的社区讨论
<div align="center">
🌟 如果您觉得这很有帮助，请给这个仓库点赞！
为AI开发社区用心打造
</div>