关键词

Spring应用升级应用现代化自动化运维Spring Application AdvisorLLM工具

Spring Application Advisor MCP Server 使用说明

项目简介

Spring Application Advisor MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，它使用 Spring AI MCP 框架开发，旨在为大型语言模型 (LLM) 应用提供与 VMware Tanzu Spring Application Advisor 的集成能力。通过此 MCP 服务器，LLM 客户端可以调用预定义的工具，从而实现对 Spring 应用程序的分析、版本升级规划和自动化升级等功能。

主要功能点

  • 获取 Spring 应用构建配置: 允许 LLM 获取指定源代码目录的 Spring 应用构建配置信息，为后续的升级计划做准备。
  • 获取 Spring 应用升级计划: 基于构建配置，LLM 可以请求生成详细的 Spring 应用升级计划，了解升级步骤和潜在影响。
  • 应用 Spring 应用升级计划: 在用户确认后，LLM 可以指示服务器执行升级计划的第一步，实现 Spring 应用的自动化升级。

安装步骤

  1. 安装 Advisor CLI: 确保您的机器上已安装 Advisor CLI 命令行工具，并将其添加到系统 PATH 环境变量中，以便服务器可以调用。
  2. 克隆仓库: 从 GitHub 克隆 Spring Application Advisor MCP Server 仓库到本地。 
    git clone https://github.com/cpage-pivotal/app-advisor-mcp.git
cd app-advisor-mcp
  3. 构建服务器: 使用 Maven 构建该项目。 
    ./mvnw clean package
    构建成功后，JAR 文件 'app-advisor-mcp-0.0.1-SNAPSHOT.jar' 将会在 'target' 目录下生成。

服务器配置

MCP 客户端需要配置以下 JSON 格式信息以连接到 Spring Application Advisor MCP Server。请根据您的实际环境修改以下配置：

{
  "mcpServers": {
    "app-advisor": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.transport=stdio",  // 指定 MCP 服务器使用 stdio 传输协议
        "-Dlogging.file.name=app-advisor-mcp.log", // 配置日志文件名为 app-advisor-mcp.log
        "-jar" ,
        "/path/to/app-advisor-mcp-0.0.1-SNAPSHOT.jar", //  替换为实际的 JAR 文件路径
        "--server.port=8041" //  指定服务器端口为 8041
      ],
      "env": {
        "ADVISOR_SERVER": "http://localhost:8080" //  配置 Advisor Server 的地址，默认为 http://localhost:8080
      }
  }
}

配置参数说明:

  • server name: 'app-advisor' - MCP 服务器的名称，客户端使用此名称引用服务器。
  • command: 'java' - 启动 MCP 服务器的命令，这里使用 Java 运行时环境。
  • args: 启动命令的参数列表，包括：
    • '-Dspring.ai.mcp.server.transport=stdio': 设置 Spring AI MCP 服务器使用标准输入输出 (stdio) 作为传输协议。这是 MCP 客户端与服务器通信的方式。
    • '-Dlogging.file.name=app-advisor-mcp.log': 配置日志输出到 'app-advisor-mcp.log' 文件，方便调试和监控。
    • '-jar': 指定以 JAR 包方式运行 Java 应用。
    • '/path/to/app-advisor-mcp-0.0.1-SNAPSHOT.jar': 请务必替换为实际的 'app-advisor-mcp-0.0.1-SNAPSHOT.jar' 文件在您本地文件系统中的绝对路径。
    • '--server.port=8041': 设置 Spring Boot 应用的服务器端口为 '8041'。您可以根据需要修改端口号。
  • env: 环境变量配置，用于传递服务器运行所需的额外信息。
    • 'ADVISOR_SERVER': 指定 Spring Application Advisor 后端服务的 URL。如果 Advisor Server 运行在 'http://localhost:8080'，则无需修改。如果 Advisor Server 运行在其他地址，请修改为实际地址。

注意: 请根据您的实际 JAR 文件路径替换配置中的 '/path/to/app-advisor-mcp-0.0.1-SNAPSHOT.jar'。

基本使用方法

  1. 启动 MCP 服务器: MCP 客户端会根据您在配置中提供的 'command' 和 'args' 启动 Spring Application Advisor MCP Server。
  2. LLM 客户端调用工具: 在 MCP 服务器成功启动并连接后，LLM 客户端可以通过 MCP 协议调用服务器提供的工具，例如：
    • 请求 'advisorBuildConfigGetFunction' 工具并提供源代码路径，以获取 Spring 应用的构建配置。
    • 请求 'advisorUpgradePlanGetFunction' 工具并提供源代码路径，以获取 Spring 应用的升级计划。
    • 请求 'advisorUpgradePlanApplyFunction' 工具并提供源代码路径，以应用升级计划。

具体工具调用方式和参数需要参考 MCP 客户端的文档和该 MCP 服务器提供的工具定义。通常，LLM 客户端会根据工具的描述和参数信息，自动生成合适的请求并发送给 MCP 服务器。

预期使用场景

LLM 应用可以利用此 MCP 服务器，集成 Spring Application Advisor 的能力，帮助开发者或运维人员：

  • 自动化分析 Spring 应用: 通过 LLM 驱动的工具，快速分析 Spring 应用的架构和依赖关系。
  • 智能化升级 Spring 版本: 借助 LLM 的理解和决策能力，结合 Advisor 的专业分析，实现 Spring 应用版本的智能升级规划和执行。
  • 提升 Spring 应用维护效率: 通过自动化工具和 LLM 辅助，降低 Spring 应用维护和升级的复杂度和人工成本。

信息

分类

开发者工具

访问项目