dep-diff-mcp

Translates a lockfile diff into a human-readable upgrade plan for npm, PyPI, and GitHub Actions.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
100%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,966Tokens (tool definitions)
~11.0 KBTypical response size
Moderate attention impact (1.54% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "dep-diff-mcp": {
      "command": "npx",
      "args": [
        "@digicatalyst/dep-diff-mcp"
      ]
    }
  }
}

Runnable packages

npm@digicatalyst/dep-diff-mcp0.3.2stdio

Remote endpoints

https://dep-diff.digicatalyst.ca/mcpstreamable-http

What it can do

Tool inventory

Tools (2)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢analyze_package_change(ecosystem, name, fromVersion, toVersion)

Given one package and two versions (from -> to), returns a structured upgrade analysis: semver classification, GitHub release notes summary, detected breaking changes, security advisories fixed in the range, migration guide links, and a clear recommendation. Use when the user asks about a specific package upgrade ('what changed between react 18 and 19', 'is it safe to bump axios from 0.27 to 1.0', 'what does upgrading lodash 4.17.20 to 4.17.21 fix'). Supports npm, pypi, and github-actions (use the action reference as the name, e.g. actions/checkout). For analyzing many packages at once or a Dependabot batch, use analyze_packages_bulk instead.

Input Schema

{
  "type": "object",
  "properties": {
    "ecosystem": {
      "type": "string",
      "enum": [
        "npm",
        "pypi",
        "github-actions"
      ],
      "description": "Package ecosystem"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Package name (e.g. 'react', 'requests')"
    },
    "fromVersion": {
      "type": "string",
      "minLength": 1,
      "description": "Current version (e.g. '18.2.0')"
    },
    "toVersion": {
      "type": "string",
      "minLength": 1,
      "description": "Target version (e.g. '19.0.0')"
    }
  },
  "required": [
    "ecosystem",
    "name",
    "fromVersion",
    "toVersion"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "package": {
      "type": "string",
      "description": "Package name that was analyzed"
    },
    "ecosystem": {
      "type": "string",
      "enum": [
        "npm",
        "pypi",
        "github-actions"
      ],
      "description": "Package ecosystem"
    },
    "fromVersion": {
      "type": "string",
      "description": "Version being upgraded from"
    },
    "toVersion": {
      "type": "string",
      "description": "Version being upgraded to"
    },
    "semverClass": {
      "type": "string",
      "enum": [
        "major",
        "minor",
        "patch",
        "downgrade",
        "unknown"
      ],
      "description": "Semver relationship between the two versions"
    },
    "repoUrl": {
      "description": "Source repository URL, or null when none could be resolved",
      "type": [
        "string",
        "null"
      ]
    },
    "releaseCount": {
      "type": "number",
      "description": "Number of GitHub releases found strictly between the two versions"
    },
    "breakingChanges": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Breaking changes extracted from release notes; empty when none were found"
    },
    "releaseExcerpts": {
      "description": "Raw release-note excerpts, present only as a fallback when a major/minor bump yielded no breaking changes",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "tag": {
            "type": "string",
            "description": "Release tag the excerpt came from"
          },
          "excerpt": {
            "type": "string",
            "description": "Short excerpt of the release notes"
          }
        },
        "required": [
          "tag",
          "excerpt"
        ],
        "additionalProperties": false
      }
    },
    "securityFixes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Advisory identifier (e.g. 'GHSA-29mw-wpgm-hmr9' or a CVE)"
          },
          "summary": {
            "type": "string",
            "description": "One-line description of the advisory"
          },
          "severity": {
            "type": "string",
            "description": "Severity as reported by OSV (e.g. 'LOW', 'MODERATE', 'HIGH', 'CRITICAL')"
          }
        },
        "required": [
          "id",
          "summary",
          "severity"
        ],
        "additionalProperties": false
      },
      "description": "Advisories affecting fromVersion that are resolved at toVersion"
    },
    "migrationLinks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Migration or upgrade guide URLs found in release notes"
    },
    "recommendation": {
      "type": "string",
      "description": "Single-line verdict explaining the recommendation level"
    },
    "recommendationLevel": {
      "type": "string",
      "enum": [
        "safe",
        "likely-safe",
        "review",
        "caution",
        "security"
      ],
      "description": "Risk classification, used to rank packages in bulk results"
    }
  },
  "required": [
    "package",
    "ecosystem",
    "fromVersion",
    "toVersion",
    "semverClass",
    "repoUrl",
    "releaseCount",
    "breakingChanges",
    "securityFixes",
    "migrationLinks",
    "recommendation",
    "recommendationLevel"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢analyze_packages_bulk(changes)

Analyzes a list of package upgrades in parallel and returns a unified risk report with packages ranked by recommendation level (security > caution > review > likely-safe > safe). Use when the user provides many dependency changes from a Dependabot PR, npm outdated output, lockfile diff, or batch upgrade. Returns: total count, breakdown by semver class, total security fixes found, packages with breaking changes, and per-package details. Limit 50 packages per call (chunk larger lists).

Input Schema

{
  "type": "object",
  "properties": {
    "changes": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ecosystem": {
            "type": "string",
            "enum": [
              "npm",
              "pypi",
              "github-actions"
            ],
            "description": "Package ecosystem"
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "fromVersion": {
            "type": "string",
            "minLength": 1
          },
          "toVersion": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "ecosystem",
          "name",
          "fromVersion",
          "toVersion"
        ]
      },
      "description": "List of package changes to analyze"
    }
  },
  "required": [
    "changes"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "totalPackages": {
      "type": "number",
      "description": "Number of package changes submitted"
    },
    "bySemverClass": {
      "type": "object",
      "properties": {
        "major": {
          "type": "number",
          "description": "Count of major bumps"
        },
        "minor": {
          "type": "number",
          "description": "Count of minor bumps"
        },
        "patch": {
          "type": "number",
          "description": "Count of patch bumps"
        }
      },
      "required": [
        "major",
        "minor",
        "patch"
      ],
      "additionalProperties": false,
      "description": "Breakdown of the batch by semver class"
    },
    "securityFixesTotal": {
      "type": "number",
      "description": "Total security advisories resolved across the whole batch"
    },
    "packagesWithBreakingChanges": {
      "type": "number",
      "description": "How many packages had at least one breaking change"
    },
    "packages": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "package": {
                "type": "string",
                "description": "Package name that was analyzed"
              },
              "ecosystem": {
                "type": "string",
                "enum": [
                  "npm",
                  "pypi",
                  "github-actions"
                ],
                "description": "Package ecosystem"
              },
              "fromVersion": {
                "type": "string",
                "description": "Version being upgraded from"
              },
              "toVersion": {
                "type": "string",
                "description": "Version being upgraded to"
              },
              "semverClass": {
                "type": "string",
                "enum": [
                  "major",
                  "minor",
                  "patch",
                  "downgrade",
                  "unknown"
                ],
                "description": "Semver relationship between the two versions"
              },
              "repoUrl": {
                "description": "Source repository URL, or null when none could be resolved",
                "type": [
                  "string",
                  "null"
                ]
              },
              "releaseCount": {
                "type": "number",
                "description": "Number of GitHub releases found strictly between the two versions"
              },
              "breakingChanges": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Breaking changes extracted from release notes; empty when none were found"
              },
              "releaseExcerpts": {
                "description": "Raw release-note excerpts, present only as a fallback when a major/minor bump yielded no breaking changes",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "tag": {
                      "type": "string",
                      "description": "Release tag the excerpt came from"
                    },
                    "excerpt": {
                      "type": "string",
                      "description": "Short excerpt of the release notes"
                    }
                  },
                  "required": [
                    "tag",
                    "excerpt"
                  ],
                  "additionalProperties": false
                }
              },
              "securityFixes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Advisory identifier (e.g. 'GHSA-29mw-wpgm-hmr9' or a CVE)"
                    },
                    "summary": {
                      "type": "string",
                      "description": "One-line description of the advisory"
                    },
                    "severity": {
                      "type": "string",
                      "description": "Severity as reported by OSV (e.g. 'LOW', 'MODERATE', 'HIGH', 'CRITICAL')"
                    }
                  },
                  "required": [
                    "id",
                    "summary",
                    "severity"
                  ],
                  "additionalProperties": false
                },
                "description": "Advisories affecting fromVersion that are resolved at toVersion"
              },
              "migrationLinks": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Migration or upgrade guide URLs found in release notes"
              },
              "recommendation": {
                "type": "string",
                "description": "Single-line verdict explaining the recommendation level"
              },
              "recommendationLevel": {
                "type": "string",
                "enum": [
                  "safe",
                  "likely-safe",
                  "review",
                  "caution",
                  "security"
                ],
                "description": "Risk classification, used to rank packages in bulk results"
              }
            },
            "required": [
              "package",
              "ecosystem",
              "fromVersion",
              "toVersion",
              "semverClass",
              "repoUrl",
              "releaseCount",
              "breakingChanges",
              "securityFixes",
              "migrationLinks",
              "recommendation",
              "recommendationLevel"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "package": {
                "type": "string",
                "description": "Package name whose analysis failed"
              },
              "error": {
                "type": "string",
                "description": "Why the analysis could not be completed"
              },
              "recommendationLevel": {
                "type": "string",
                "const": "review",
                "description": "Always 'review' — a package that could not be analyzed cannot be cleared automatically"
              }
            },
            "required": [
              "package",
              "error",
              "recommendationLevel"
            ],
            "additionalProperties": false
          }
        ]
      },
      "description": "Per-package results, ranked security > caution > review > likely-safe > safe"
    }
  },
  "required": [
    "totalPackages",
    "bySemverClass",
    "securityFixesTotal",
    "packagesWithBreakingChanges",
    "packages"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded2 tools
verifiedversion not recorded2 tools
verifiedversion not recorded2 tools