QLExpress MCP Server
QLExpress MCP Server 是一个基于 Model Context Protocol (MCP) 的 QLExpress 表达式执行和分析服务器实现。
项目介绍
本项目提供了一个完整的 MCP 服务器，支持 QLExpress 表达式的执行和分析。
服务器支持两种运行模式：stdio 模式 和 SSE 模式。
快速开始
环境要求
- Java 17 或更高版本
- Maven 3.6 或更高版本
构建项目
mvn clean package构建完成后，可执行 JAR 文件将位于 target/qlexpress-mcp-server-1.0.0.jar。
启动方法
stdio 模式
stdio 模式通过标准输入输出进行通信，适合与本地工具集成：
java -jar -Dspring.ai.mcp.server.stdio=true -Dspring.main.web-application-type=none target/qlexpress-mcp-server-1.0.0.jarSSE 模式
SSE 模式通过 HTTP Server-Sent Events 进行通信，适合 Web 应用和远程调用：
java -jar target/qlexpress-mcp-server-1.0.0.jar使用案例
以下是一个典型的使用案例，展示了如何通过 MCP 客户端调用 QLExpress 服务器分析导致表达式结果为 false 的原因：
Prompt:
qlexpress脚本：`isVip(userId) && (未登录天数(userId) > 10 || 购物车(userId).isEmpty())`，脚本上下文：`{"userId": 1234}`，
解释导致脚本执行结果的原因。回答请尽量精简且通俗开发指南
项目结构
基于 Spring AI 实现
qlexpress-mcp/
├── src/main/java/com/example/qlexpressmcp/
│ ├── QLExpressMcpServerApplication.java # 主应用类
│ └── QLExpressExecuteService.java # 表达式执行服务
├── src/main/resources/
│ └── application.yml # 配置文件
└── src/test/ # 测试代码修改自定义函数
com.example.qlexpressmcp.QLExpressExecuteService 中的自定义函数修改成业务中实际的自定义函数。