Maven Dependencies MCP Server 使用说明

项目简介

Maven Dependencies MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为语言模型（LLM）应用提供访问 Maven Central Repository 的能力。通过此服务器，LLM 可以查询 Maven 依赖的最新版本，并验证特定版本是否存在，从而更好地理解和生成与 Maven 依赖相关的代码或信息。

主要功能点

查询 Maven 依赖最新版本: 允许 LLM 获取指定 Maven 依赖的最新版本信息。
验证 Maven 依赖版本是否存在: 允许 LLM 确认 Maven Central Repository 中是否存在特定的 Maven 依赖版本。
支持多种 Maven 坐标格式: 支持 groupId:artifactId[:version][:packaging][:classifier] 格式的 Maven 坐标，满足各种依赖查询需求。
实时数据: 直接从 Maven Central Repository 获取数据，保证信息的实时性和准确性。
广泛兼容性: 理论上兼容使用 Maven 依赖管理的项目，包括 Maven、Gradle、SBT、Mill 等构建工具的项目。

安装步骤

前提条件: 确保您的环境中已安装 Node.js 和 npm (Node Package Manager)。
全局安装 (推荐): 打开终端，运行以下命令全局安装 'mcp-maven-deps' 包：
```
npm install -g mcp-maven-deps
```
直接运行 (npx): 如果您不想全局安装，可以使用 'npx' 直接运行：
```
npx mcp-maven-deps
```

服务器配置

要让 MCP 客户端连接到 Maven Dependencies Server，您需要在客户端的 MCP 服务器配置中添加以下 JSON 配置信息。

如果全局安装，使用以下配置：

{
  "mcpServers": {
    "maven-deps-server": { // "maven-deps-server" 是您为该服务器定义的名称，可以自定义
      "command": "mcp-maven-deps" // 启动服务器的命令，这里直接使用全局安装的命令名
    }
  }
}

如果使用 'npx' 运行，使用以下配置：

{
  "mcpServers": {
    "maven-deps-server": { // "maven-deps-server" 是您为该服务器定义的名称，可以自定义
      "command": "npx",     // 启动服务器的命令
      "args": ["mcp-maven-deps"] // 命令参数，指定要运行的包名
    }
  }
}

请将以上 JSON 配置添加到您的 MCP 客户端的配置文件中。具体的配置文件位置和格式请参考您的 MCP 客户端文档。

基本使用方法

成功安装并配置 Maven Dependencies Server 后，您的 LLM 应用可以通过 MCP 协议调用以下工具来使用服务器的功能。

可用工具：

'get_maven_latest_version': 获取 Maven 依赖的最新版本。
- 参数: 'dependency' (字符串类型)，Maven 坐标，格式为 "groupId:artifactId[:version][:packaging][:classifier]"，例如 '"org.springframework:spring-core"' 或 '"org.springframework:spring-core:5.3.20:jar"'。
- 示例: 调用工具并传入参数 '{ "dependency": "org.springframework:spring-core" }'，服务器将返回该依赖的最新版本号。
'check_maven_version_exists': 检查 Maven 依赖的特定版本是否存在。
- 参数:
  - 'dependency' (字符串类型)，Maven 坐标，格式同上。
  - 'version' (字符串类型，可选)，要检查的版本号。如果 'dependency' 参数中已包含版本号，则可以省略此参数。
- 示例:
  - 检查特定版本是否存在 (版本号在 'dependency' 中): 调用工具并传入参数 '{ "dependency": "org.springframework:spring-core:5.3.20" }'。
  - 检查特定版本是否存在 (版本号作为单独参数): 调用工具并传入参数 '{ "dependency": "org.springframework:spring-core", "version": "5.3.20" }'。
- 返回值: 服务器将返回 '"true"' 或 '"false"' 文本，表示版本是否存在。

请参考您的 MCP 客户端的文档，了解如何调用 MCP 服务器的工具。通常，您需要使用 MCP 客户端提供的 API，指定服务器名称（例如 '"maven-deps-server"'）、工具名称（例如 '"get_maven_latest_version"'）和参数。

关键词