Dependency MCP

🚀 依賴MCP服務器

依賴MCP服務器是一個模型上下文協議（MCP）服務器，用於跨多個包管理器和註冊表檢查包版本。它能夠極大提升包版本管理的效率，確保項目使用的包為最新且兼容的版本。

✨ 主要特性

• 多語言支持：可檢查來自NPM、PyPI、Maven、NuGet、RubyGems、Crates.io和Go模塊的包。
• 最新版本查詢：獲取任何包的最新版本。
• 版本存在性檢查：驗證特定版本是否存在。
• 包信息獲取：獲取包括所有版本在內的詳細包元數據。
• 批量處理：同時檢查多個包，提高效率。
• 輕鬆安裝：可通過npx進行安裝和運行。

📦 安裝指南

全局安裝

npm install -g dependency-mcp

使用npx運行（無需安裝）

npx dependency-mcp

本地開發

git clone <repository>
cd dependency-mcp
npm install
npm start

💻 使用示例

基礎用法

服務器作為一個使用標準輸入輸出傳輸的MCP服務器運行，旨在與兼容MCP的客戶端配合使用。

高級用法

本服務器提供了多種工具，可根據不同需求進行選擇。

單包工具

當你需要檢查 1 - 2個包 或需要 詳細信息 時，可以使用這些工具：

• get_latest_version：獲取包的最新版本，可用於依賴更新、版本檢查或獲取最新穩定版本。
  • 參數：
    • package_name（字符串）：包的名稱。
    • registry（字符串）：包註冊表（npm、pypi、maven、nuget、rubygems、crates、go）。
  • 示例：

{
  "package_name": "express",
  "registry": "npm"
}

• check_version_exists：檢查特定版本是否存在，可用於依賴驗證、CI/CD檢查或確保版本兼容性。
  • 參數：
    • package_name（字符串）：包的名稱。
    • version（字符串）：要檢查的版本。
    • registry（字符串）：包註冊表。
  • 示例：

{
  "package_name": "flask",
  "version": "2.3.0",
  "registry": "pypi"
}

• get_package_info：獲取包括所有版本在內的詳細包信息，可用於依賴審計、安全審查或獲取全面的包元數據。
  • 參數：
    • package_name（字符串）：包的名稱。
    • registry（字符串）：包註冊表。
  • 示例：

{
  "package_name": "lodash",
  "registry": "npm"
}

多包工具

當你需要檢查 3個或更多包 或執行 批量操作 時，可以使用這些工具：

• get_latest_versions：同時獲取多個包的最新版本，適用於檢查3個或更多依賴，可並行處理多達100個包。
  • 參數：
    • packages（數組）：包名稱數組。
    • registry（字符串）：包註冊表。
  • 示例：

{
  "packages": ["react", "lodash", "axios"],
  "registry": "npm"
}

• check_versions_exist：檢查多個包的特定版本是否存在，可用於批量依賴驗證、CI/CD管道檢查或確保多個包版本的兼容性。
  • 參數：
    • packages（數組）：包含package_name和version的包對象數組。
    • registry（字符串）：包註冊表。
  • 示例：

{
  "packages": [
    { "package_name": "react", "version": "18.2.0" },
    { "package_name": "lodash", "version": "4.17.21" },
    { "package_name": "axios", "version": "1.6.0" }
  ],
  "registry": "npm"
}

• get_packages_info：獲取多個包的全面詳細信息，可用於依賴審計、安全審查或批量包分析。
  • 參數：
    • packages（數組）：包名稱數組。
    • registry（字符串）：包註冊表。
  • 示例：

{
  "packages": ["react", "lodash", "axios"],
  "registry": "npm"
}

📚 詳細文檔

工具選擇指南

何時使用單包工具

• 檢查 1 - 2個包。
• 需要 詳細信息（版本、主頁、倉庫）。
• 對單個包進行 特定版本驗證。
• 開發過程中的 快速檢查。

何時使用多包工具

• 檢查 3個或更多包。
• 進行 批量依賴驗證。
• 進行 CI/CD管道檢查。
• 進行 依賴審計 或安全審查。
• 處理多個包的 性能關鍵 場景。

性能說明

• 單包工具：檢查1 - 2個包時速度更快。
• 多包工具：檢查5個或更多包時，由於並行處理，速度比單包工具快3 - 5倍。
• 錯誤隔離：失敗的包不會影響整個批次。
• 批量限制：每個請求最多處理100個包。

批量處理

多包工具在檢查多個包時可顯著提高性能：

優點

• 消除往返延遲：單個請求可檢查多達100個包。
• 一致的錯誤處理：單個包的失敗不會影響整個批次。
• 並行處理：所有包同時檢查，效率最高。
• 減少API開銷：減少對外部註冊表的HTTP請求。

限制

• 最大批量大小：每個請求最多處理100個包。
• 速率限制：內置延遲，防止對外部API造成過大壓力。
• 超時處理：每個請求有10秒超時時間，並提供優雅的回退機制。
• 內存使用：大批量處理可能會消耗更多內存。

何時使用批量工具

• 依賴審計：檢查項目中的多個包。
• 版本比較：比較多個包的版本。
• 批量更新：確定哪些包有可用的新版本。
• CI/CD管道：同時驗證多個包的版本。

生產環境考慮因素

性能

• 併發處理：多包工具使用Promise.all進行並行執行。
• 速率限制：請求外部API時，內置100ms延遲。
• 超時處理：10秒超時，並進行優雅的錯誤處理。
• 內存管理：高效處理大批量數據。

可靠性

• 錯誤隔離：單個包的失敗不會影響批次中的其他包。
• 網絡彈性：優雅處理臨時網絡問題。
• API回退：外部API不可用時進行優雅降級。
• 驗證：全面的輸入驗證，防止無效請求。
• 特定註冊表處理：在某些網絡環境中，Maven註冊表可能較慢。

安全性

• 輸入清理：所有輸入都經過驗證和清理。
• 速率限制：防止濫用外部API。
• 錯誤消息：安全的錯誤消息，不暴露內部細節。
• 超時保護：防止請求掛起。

監控

• 時間戳：所有響應都包含ISO時間戳，便於跟蹤。
• 錯誤跟蹤：詳細的錯誤信息，便於調試。
• 性能指標：內置超時和速率限制跟蹤。

與Claude Desktop配置

將以下內容添加到Claude Desktop配置文件中：

Windows

%APPDATA%\Claude\claude_desktop_config.json

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Linux

~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "dependency-checker": {
      "command": "npx",
      "args": ["dependency-mcp"]
    }
  }
}

示例響應

最新版本響應

{
  "package": "express",
  "registry": "npm",
  "found": true,
  "latest_version": "4.18.2",
  "description": "Fast, unopinionated, minimalist web framework"
}

版本檢查響應

{
  "package": "flask",
  "version": "2.3.0",
  "registry": "pypi",
  "exists": true
}

包信息響應

{
  "package": "lodash",
  "registry": "npm",
  "found": true,
  "latest_version": "4.17.21",
  "description": "Lodash modular utilities.",
  "versions": ["4.17.21", "4.17.20", "..."],
  "homepage": "https://lodash.com/",
  "repository": "git+https://github.com/lodash/lodash.git"
}

特殊格式說明

Maven

Maven包應使用groupId:artifactId格式指定：

{
  "package_name": "org.springframework:spring-core",
  "registry": "maven"
}

Go模塊

Go模塊應使用完整的模塊路徑：

{
  "package_name": "github.com/gorilla/mux",
  "registry": "go"
}

錯誤處理

服務器為常見場景提供詳細的錯誤消息：

• 包未找到
• 網絡連接問題
• 無效的包名稱格式
• 註冊表API錯誤
• 速率限制超出
• 服務器錯誤（5xx響應）
• 請求超時
• 輸入驗證錯誤

錯誤響應格式

所有錯誤響應都包含：

• error：人類可讀的錯誤消息。
• timestamp：錯誤發生的ISO時間戳。
• package：導致錯誤的包名稱。
• registry：發生錯誤的註冊表。

輸入驗證

服務器對所有輸入進行驗證：

• 包名稱：必須是非空字符串，長度不超過500個字符。
• 版本：必須是非空字符串，長度不超過100個字符。
• 註冊表：必須是支持的註冊表之一。
• 批量大小：每個請求最多處理100個包。
• 必需參數：所有必需字段必須存在。

響應預期

單包工具

• 成功：返回完整的包信息，found: true。
• 未找到：返回found: false和錯誤消息。
• 網絡問題：返回帶有描述性消息的錯誤。
• 始終包含：timestamp、package、registry字段。

多包工具

• 成功：返回結果數組，每個結果都有單獨的狀態。
• 部分成功：部分包成功，部分包失敗，每個包都有單獨的結果。
• 錯誤隔離：失敗的包不會影響成功的包。
• 批量處理：所有包並行處理，提高效率。
• 格式一致：每個結果的結構與單包工具相同。

🔧 技術細節

項目結構

dependency-mcp/
├── src/
│   ├── index.js          # 主MCP服務器
│   └── packageChecker.js # 包註冊表處理程序
├── test/
│   └── test.js          # 基本測試
├── package.json
└── README.md

運行測試

npm test

調試模式

npm run dev

📄 許可證

本項目採用MIT許可證。