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许可证。