项目简介

ZenWave MCP服务器是ZenWave SDK的一部分，专注于实现Model Context Protocol (MCP)，作为大型语言模型 (LLM) 应用的后端服务。它允许LLM客户端通过标准化的JSON-RPC接口访问软件项目的特定上下文信息和功能，特别是与ZenWave SDK处理的ZDL (ZenWave Domain Language) 模型相关的工具。

主要功能点

该服务器主要提供以下能力给LLM客户端：

• 基于ZDL的工具: 提供查询和分析ZDL模型的能力，例如生成项目任务清单或绘制聚合UML图。
• 标准化通信: 通过JSON-RPC协议接收客户端请求并返回结构化响应。
• Spring AI集成: 利用Spring AI框架简化工具的声明和调用。

安装步骤

ZenWave MCP服务器作为ZenWave SDK的一个模块存在。要运行服务器，您需要：

1. 克隆ZenWave SDK GitHub仓库。
2. 根据Maven项目标准构建整个SDK，生成可执行的'zenwave-sdk-mcp-server'模块JAR文件。
3. 该JAR文件即为MCP服务器的可运行程序。

具体构建和打包步骤请参考ZenWave SDK的官方文档和Maven构建说明。

服务器配置

MCP客户端通常通过JSON配置来启动并连接MCP服务器。对于ZenWave MCP服务器，典型的配置需要包含以下信息：

• 'name': 服务器的显示名称（例如："ZenWave MCP Server"）。
• 'command': 启动服务器进程的命令。这通常是'java'。
• 'args': 传递给命令的参数列表。这通常包括'-jar'以及ZenWave MCP服务器模块的JAR文件路径。根据您的构建结果，这个路径可能类似于 'path/to/zenwave-sdk/plugins/zenwave-mcp-server/target/zenwave-sdk-mcp-server-<version>.jar'。

LLM客户端将使用这些配置信息来启动和管理MCP服务器进程，并通过配置的传输协议（例如Stdio）进行通信。

基本使用方法

MCP客户端（如支持MCP的LLM应用）会通过配置信息启动ZenWave MCP服务器。一旦连接建立，客户端可以发送JSON-RPC请求来调用服务器暴露的工具。例如，客户端可以发送一个请求，提供ZDL文件的内容作为参数，调用'getProjectTaskList'工具来获取项目的任务清单，或者调用'getAggregateUML'工具并指定聚合名称和ZDL内容来获取UML图。

LLM可以通过这些工具获取结构化的项目信息，从而更好地理解项目结构、领域模型和服务，辅助进行代码生成、架构分析或任务规划等工作。