使用说明

项目简介

本项目是一个基于 Spring AI MCP Server 框架构建的 MCP 服务器，旨在向支持 Model Context Protocol (MCP) 的 LLM 客户端提供课程信息查询服务。它通过标准化的 MCP 协议，暴露了获取所有课程和按标题搜索课程的工具，使得 LLM 能够方便地访问和利用这些课程数据。

主要功能点

提供课程数据资源: 服务器内置了简单的课程数据，可以扩展为连接数据库或其他数据源以提供更丰富的课程信息。
暴露课程查询工具: 通过 MCP 协议注册了两个工具：
- 'dv_get_courses': 获取所有可用课程的列表。
- 'dv_get_course': 根据课程标题获取单个课程的详细信息。
基于 Spring AI MCP Server: 利用 Spring AI 框架简化了 MCP 服务器的开发，提供了良好的扩展性和集成性。
支持 STDIO 传输: 通过标准输入/输出进行 MCP 通信，无需网络端口，配置简单。

安装步骤

安装 Java 24 和 Maven: 确保您的系统已安装 Java 24 或更高版本，并配置好 Maven 3.8+。
克隆仓库: 使用 Git 克隆仓库 'https://github.com/danvega/dv-courses-mcp' 到本地。
构建项目: 在项目根目录下，打开终端并执行命令 'mvn spring-boot:run'。这将下载依赖并启动 MCP 服务器。

服务器配置

对于 MCP 客户端（例如 Claude Desktop Client），您需要配置连接到此 MCP 服务器。以下是一个 Claude Desktop Client 的配置示例，用于连接到本课程信息 MCP 服务器：

{
  "dan-vega-mcp": {
    "command": "/path/to/java",
    "args": [
      "-jar",
      "/path/to/courses-0.0.1-SNAPSHOT.jar"
    ]
  }
}

配置参数说明:

'"dan-vega-mcp"': 服务器名称，客户端通过此名称识别和调用该 MCP 服务器提供的工具。您可以自定义名称。
'"command"': Java 运行命令的绝对路径。
- 请替换 '/path/to/java' 为您本地 Java 24 或更高版本的安装路径。 例如：'/usr/bin/java' 或 'C:\Program Files\Java\jdk-24\bin\java'。
'"args"': 传递给 Java 命令的参数列表，用于启动 MCP 服务器 JAR 文件。
- '"-jar"': 指定运行 JAR 文件。
- '"/path/to/courses-0.0.1-SNAPSHOT.jar"': MCP 服务器 JAR 文件的绝对路径。
  - 请替换 '/path/to/courses-0.0.1-SNAPSHOT.jar' 为您在本地构建后 'courses-mcp/target/' 目录下生成的 JAR 文件路径。 您可能需要先使用 'mvn package' 命令在项目根目录构建项目以生成 JAR 文件。

配置注意事项:

确保 'command' 和 'args' 中的路径指向您本地正确的 Java 路径和 JAR 文件路径。
MCP 客户端需要能够执行 'command' 中指定的命令。
此配置示例适用于使用 STDIO 传输的 MCP 服务器。

基本使用方法

启动 MCP 服务器: 按照安装步骤启动 'dv-courses-mcp' 服务器。服务器将通过标准输入/输出等待客户端请求。
配置并连接 MCP 客户端: 在您的 MCP 客户端（如 Claude Desktop Client）中，根据上述 “服务器配置” 部分进行配置，确保客户端能够找到并启动 MCP 服务器。
客户端调用工具: 客户端成功连接到 MCP 服务器后，即可通过服务器名称 ('dan-vega-mcp') 调用已注册的工具，例如：
- 请求调用 'dv_get_courses' 工具以获取所有课程列表。
- 请求调用 'dv_get_course' 工具并提供课程标题参数，以获取特定课程的详细信息。
服务器响应: MCP 服务器将处理客户端的工具调用请求，并返回包含课程数据的 JSON-RPC 响应。客户端可以解析响应并利用课程信息进行后续操作。

关键词