Bigsy Maven MCP Server

🚀 Maven 依賴 MCP 服務器

這是一個 MCP（模型上下文協議）服務器，提供工具用於檢查 Maven 依賴版本。藉助該服務器，大型語言模型能夠驗證 Maven 依賴項，並從 Maven 中央倉庫檢索其最新版本。

✨ 主要特性

• 可查詢任何 Maven 依賴項的最新版本。
• 能夠驗證某個 Maven 依賴項是否存在。
• 可以檢查特定版本的依賴項是否存在。
• 支持即時訪問 Maven 中央倉庫數據。

📦 安裝指南

1. 克隆或下載此倉庫。
2. 安裝依賴：

npm install

3. 構建服務器：

npm run build

🛠️ 配置說明

將服務器添加到您的 MCP 設置配置文件中：

{
  "mcpServers": {
    "maven-deps-server": {
      "command": "node",
      "args": ["/path/to/maven-deps-server/build/index.js"]
    }
  }
}

💻 使用示例

get_maven_latest_version

檢索某個 Maven 依賴項的最新版本。 輸入 schema:

{
  "type": "object",
  "properties": {
    "dependency": {
      "type": "string",
      "description": "Maven 依賴項格式為 \"groupId:artifactId\"（例如 \"org.springframework:spring-core\"）"
    }
  },
  "required": ["dependency"]
}

示例用法：

const result = await mcpClient.callTool("maven-deps-server", "get_maven_latest_version", {
  dependency: "org.springframework:spring-core"
});
// 返回： "6.2.1"

check_maven_version_exists

檢查某個特定版本的 Maven 依賴項是否存在。 輸入 schema:

{
  "type": "object",
  "properties": {
    "dependency": {
      "type": "string",
      "description": "Maven 依賴項格式為 \"groupId:artifactId\"（例如 \"org.springframework:spring-core\"）"
    },
    "version": {
      "type": "string",
      "description": "要檢查的版本（例如 \"5.3.20\"）"
    }
  },
  "required": ["dependency", "version"]
}

示例用法：

const result = await mcpClient.callTool("maven-deps-server", "check_maven_version_exists", {
  dependency: "org.springframework:spring-core",
  version: "5.3.20"
});
// 返回： "true" 或 "false"

示例響應

最新版本檢查

// 輸入： org.springframework:spring-core
"6.2.1"

// 輸入： org.apache.kafka:kafka-clients
"3.7.2"

// 輸入： nonexistent.group:fake-artifact
"Maven 依賴項中未找到 nonexistent.group:fake-artifact"

版本存在性檢查

// 輸入： { dependency: "org.springframework:spring-core", version: "5.3.20" }
"true"

// 輸入： { dependency: "org.springframework:spring-core", version: "0.0.1" }
"false"

🔧 技術細節

• 利用 Maven 中央倉庫的 REST API 拉取依賴項信息。
• 根據時間戳對結果進行排序，以此確保返回最新版本。
• 包含針對無效依賴項和 API 問題的錯誤處理。
• 返回有效依賴項的乾淨、可解析的版本字符串。
• 提供版本存在性檢查的布爾響應。

❗ 錯誤處理

服務器能夠處理各種錯誤情況，包括：

• 無效依賴項格式。
• 網絡連接問題。
• 無法找到依賴項信息。

📚 詳細文檔

要維護或擴展此服務器，可以參考以下倉庫和文檔：

• GitHub 倉庫
• 項目文檔

📄 許可證

[此處插入許可證詳細信息]