AI驱动规划系统

MCPIntelliplan是一个基于模型上下文协议(MCP)的结构化AI驱动规划系统,结合大型语言模型和确定性后端逻辑,适用于企业级架构的规划工作流。

  • by AhmedHB
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 AhmedHB/MCPIntelliplan

使用说明

MCPIntelliplan


🚀 概述

MCPIntelliplan 是一个结构化的人工智能驱动的规划系统 模型上下文协议(MCP)。

解决方案包括:

  • 🖥 前端(React)——用于规划工作流和用户交互的Web UI
  • 🧠 MCP客户端——LLM驱动的路由、意图分类和工具 编排
  • ⚙️ MCP服务器——确定性业务逻辑和验证层
  • 🗄 数据库(PostgreSQL)——持久结构化数据存储

该系统演示了如何将大型语言模型与 在干净的企业风格架构中实现确定性后端逻辑。


🏗 系统架构

用户
↓
前端(React)
↓
MCP客户端(LLM:路由+意图分类)
↓
MCP工具调用(SSE)
↓
MCP服务器(业务逻辑+验证)
↓
数据库(PostgreSQL)


🎯 设计原则

  • LLM解释自然语言
  • 服务器执行业务规则
  • LLM内部没有业务逻辑
  • 确定性匹配和验证
  • 明确职责分工
  • 企业就绪架构

📦 项目结构

MCPIntelliplan/
├── Intelliplan/(React前端)
├── MCPServer/(Spring Boot MCP后端)
├── MCPClient/(Spring Boot LLM客户端)
├── docker-compose.yml
└── README.md


🖥 前端(React)

前端应用程序位于 Intelliplan/ 并提供web UI。

运行:

cd智能计划
npm安装
npm启动

默认URL:

http://localhost:3000


🧠 MCP客户端

MCP客户端:

  • 将用户输入路由到正确的域
  • 将意图分类为结构化命令
  • 通过SSE调用MCP工具
  • 格式化响应
  • 作为CLI应用程序运行(无web服务器)

支持两种运行时模式:

本地模式(Ollama)mvn春季启动:运行-Plocal

云模式(OpenAI)mvn春季启动:运行-Pcloud

需要:-MCP服务器正在运行http://localhost:9090-数据库 正在运行(通过Docker)


⚙️ MCP服务器

MCP服务器将业务逻辑作为MCP工具公开:

  • 顾问管理
  • 任务处理
  • 可用性跟踪
  • 服务(技能)管理
  • 确定性咨询建议引擎

运行:

docker compose up-d mvn spring boot:run

SSE端点:

http://localhost:9090/sse


🔎 MCP检查员

检查工具并调试MCP通信:

npx@modelcontextprotocol/检查器

连接到:

http://localhost:9090/sse


🧪 示例流程

用户:“为任务ASSIGN_300009建议顾问”

  1. 客户端路由到分配域
  2. 意图分类器提取assignmentId
  3. MCP工具分配_suggest_consults被调用
  4. 服务器执行确定性匹配
  5. 返回结果并格式化

🔐 安全说明

  • API密钥存储在cloud.env.properties中(被Git忽略)
  • 永远不要泄露真正的秘密
  • 使用.env.example模式进行安全配置

🚀 如何运行一切

  1. 启动数据库
    docker组成-up-d

  2. 启动MCP服务器
    cd MCP服务器
    mvn春季开机:运行

  3. 启动MCP客户端
    cd MCP客户端
    mvn春季开机:运行-Plocal

  4. 启动前端
    cd智能计划
    npm安装
    npm启动


📌 摘要

MCPIntelliplan展示了:

  • 结构化AI架构
  • 基于MCP工具的编排
  • LLM和业务逻辑的清晰分离
  • 企业风格模块化设计
  • 安全配置处理

📄 许可证

在此处指定许可证(MIT、Apache 2.0等)。