关键词

图书查询Spring AI工具调用数据服务LLM后端

使用说明

项目简介

本项目是一个基于 Spring AI 框架构建的 MCP 服务器示例，旨在演示如何使用 Spring AI 的工具功能来为 LLM 客户端提供结构化的数据访问能力。服务器端提供了图书管理功能，通过工具的形式暴露了图书查询接口，客户端可以通过调用这些工具来查询图书信息。

主要功能点

  • 📚 图书数据管理: 服务器端集成了图书数据，并提供了对图书数据的存储和管理功能。
  • 🔍 图书查询工具: 通过预定义的工具接口，支持 LLM 客户端根据书名、作者或分类查询图书信息。这些工具可以被 LLM 智能体调用，从而实现更强大的信息检索能力。

安装步骤

  1. 环境准备: 确保已安装 JDK 17 或更高版本，并配置好 Maven 或 Gradle 构建工具。
  2. 下载代码: 从 GitHub 仓库克隆或下载 'spring-ai-mcp-deepseek' 项目代码到本地。
  3. 进入服务器目录: 打开终端或命令提示符，进入 'mcp-server' 目录。
  4. 构建并运行: 使用 Maven 或 Gradle 构建并运行 Spring Boot 应用。例如，使用 Maven 可以执行 'mvn spring-boot:run' 命令，或使用 Gradle 执行 './gradlew bootRun' 命令。

服务器配置

MCP客户端需要配置以下信息以连接到本MCP服务器：

{
  "serverName": "spring-ai-mcp-server",
  "command": "java",
  "args": [
    "-jar",
    "path/to/mcp-server.jar"  // 请替换为 mcp-server.jar 的实际路径，通常在 mcp-server/target 目录下
  ],
  "description": "启动 Spring AI MCP 图书查询服务器",
  "notes": "请确保在运行前已使用 Maven 或 Gradle 构建 mcp-server 项目，并将 path/to/mcp-server.jar 替换为实际的 JAR 文件路径。"
}

配置参数说明:

  • 'serverName': 服务器名称，可以自定义，用于在客户端标识服务器。
  • 'command': 启动服务器的命令，这里使用 'java' 命令。
  • 'args': 启动命令的参数列表。
    • '-jar path/to/mcp-server.jar': 指定要运行的 JAR 文件路径。 请务必将 'path/to/mcp-server.jar' 替换为实际的 JAR 文件路径。 构建成功后，JAR 文件通常位于 'mcp-server/target' 目录下，文件名类似于 'mcp-server-0.0.1-SNAPSHOT.jar'。
  • 'description': 服务器描述信息，用于客户端显示。
  • 'notes': 备注信息，可以提供额外的配置说明。

基本使用方法

  1. 启动 MCP 服务器: 按照上述安装步骤和服务器配置，启动 'mcp-server' 应用。
  2. 配置 MCP 客户端: 在您的 MCP 客户端应用中，配置连接到本服务器，填入上述服务器配置信息。
  3. 客户端发起请求: 在客户端应用中，您可以向 LLM 提出关于图书查询的自然语言问题，例如：“请帮我查找 Spring 实战这本书的信息”，“有哪些周志明写的书？”或者“计算机科学分类下有哪些书？”。
  4. 服务器响应: MCP 服务器将接收到客户端的请求，并根据请求内容调用相应的图书查询工具，从图书数据库中检索信息，并将结果返回给客户端。客户端再将结果呈现给用户。

注意: 本示例仓库主要展示了 MCP 服务器端工具的注册和使用，客户端部分代码仅为简单的 Web 接口示例，实际 MCP 客户端需要根据 MCP 协议规范进行开发和配置。

信息

分类

AI与计算

访问项目