dep-diff-mcp
dep-diff-mcp
MCP-Server, der einen Lockfile-Diff in einen menschenlesbaren Upgrade-Plan übersetzt.
Richten Sie Ihren KI-Assistenten (Cursor, Claude Desktop, Claude Code) auf einen Dependabot-PR, eine npm outdated-Ausgabe oder ein beliebiges Versionspaar und Sie erhalten einen sortierten Upgrade-Plan: Semver-Klasse, Breaking Changes aus den GitHub-Release-Notizen, im Bereich behobene CVEs, Links zu Migrationsanleitungen und eine klare Empfehlung pro Paket.
Installation
Claude Code
Ein Befehl, Benutzerbereich (in jedem Projekt verfügbar):
claude mcp add -s user dep-diff -- npx -y @digicatalyst/dep-diff-mcpProjektbereich (schreibt .mcp.json in das Repository-Wurzelverzeichnis und wird mit dem Team geteilt):
claude mcp add -s project dep-diff -- npx -y @digicatalyst/dep-diff-mcpMit einem expliziten Token (überspringen Sie diesen Schritt, wenn Ihre gh-CLI authentifiziert ist — siehe GitHub-Token weiter unten):
claude mcp add -s user --env GITHUB_TOKEN=ghp_xxx dep-diff -- npx -y @digicatalyst/dep-diff-mcpÜberprüfen:
claude mcp listStarten Sie die Sitzung in Claude Code neu, damit der Server erkannt wird.
Cursor und Claude Desktop
Fügen Sie Folgendes zu Ihrer MCP-Client-Konfiguration hinzu:
Cursor:
~/.cursor/mcp.jsonClaude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS) oder%APPDATA%\Claude\claude_desktop_config.json(Windows)
{
"mcpServers": {
"dep-diff": {
"command": "npx",
"args": ["-y", "@digicatalyst/dep-diff-mcp"]
}
}
}Starten Sie Ihren MCP-Client neu. Fragen Sie etwas wie „Was ist bei diesem Dependabot-PR riskant?“ und die Werkzeuge werden automatisch aufgerufen.
Gehostete Remote-Instanz (ohne Installation)
Eine gehostete Instanz läuft unter https://dep-diff.digicatalyst.ca/mcp über Streamable HTTP, sodass Sie das npm-Paket vollständig überspringen können:
claude mcp add -s user -t http dep-diff https://dep-diff.digicatalyst.ca/mcpOder in einer Client-Konfiguration:
{
"mcpServers": {
"dep-diff": {
"type": "http",
"url": "https://dep-diff.digicatalyst.ca/mcp"
}
}
}Übergeben Sie ein GitHub-Token mit ?githubToken=ghp_xxx in der URL, wenn Sie höhere Rate-Limits möchten. Die gehostete Instanz ist zustandslos und speichert keine Protokolle Ihrer Abfragen — Siehe PRIVACY.md. Führen Sie das npm-Paket stattdessen lokal aus, wenn Sie es vorbeugen, dass Ihr Token Ihren Rechner nie verlässt.
Related MCP server: blastradius
GitHub-Token (optional, aber empfohlen)
Der Server greift auf die GitHub-API zu, um Release-Notizen zu lesen. Ohne Token erhalten Sie 60 Anfragen pro Stunde (das anonyme Limit von GitHub) — ausreichend für gelegentliche Anfragen einzelner Pakete, aber nicht für die Analyse großer Lockfiles.
Der Server ermittelt ein Token in dieser Reihenfolge:
Umgebungsvariable
GITHUB_TOKEN, sofern gesetzt.gh auth token— wenn die GitHub-CLI installiert und authentifiziert ist, verwendet der Server dieses Token automatisch. Keine Konfigurationsänderung erforderlich.Anonym (60 Anfragen pro Stunde).
Empfohlen: die gh-CLI verwenden
Wenn Sie gh bereits installiert haben (brew install gh && gh auth login), können Sie hier aufhören — der Server übernimmt Ihre vorhandene Authentifizierung. Kein Klartext-Token liegt irgendwo vor.
Alternative: Umgebungsvariable
Erstellen Sie ein feingranulares Token unter https://github.com/settings/tokens:
Token-Name:
dep-diff-mcpGültigkeit: 90 Tage (regelmäßig rotieren)
Repository-Zugriff:
Public Repositories (read-only)— kein Zugriff auf private RepositoriesBerechtigungen: keine über das Standard-Lesen öffentlicher Repositories hinaus — erteilen Sie keine
repo-,workflow-,user- oder sonstigen Schreib-Scopes
Verweisen Sie in der MCP-Konfiguration darauf:
{
"mcpServers": {
"dep-diff": {
"command": "npx",
"args": ["-y", "@digicatalyst/dep-diff-mcp"],
"env": { "GITHUB_TOKEN": "github_pat_xxx" }
}
}
}Sicherheitshinweise
Diese Konfigurationsdatei liegt im Klartext auf Ihrer Festplatte. Schränken Sie die Zugriffsrechte strikt ein (
chmod 600) und fügen Sie das Token nicht in KI-Chats, Issues oder geteilte Bildschirmsitzungen ein — Transkripte werden häufig gespeichert.Das Token in dieser Konfiguration sollte minimal privilegiert sein (nur Lesezugriff auf öffentliche Repositories). Selbst wenn es offengelegt wird, kann es nur öffentliche Daten lesen, die Sie auch ohne Token lesen können.
Rotieren Sie Tokens regelmäßig. Widerrufen Sie jedes Token, das möglicherweise offengelegt wurde, unter https://github.com/settings/tokens.
Der Server schreibt das Token nie in stdout/stderr oder in die Antwort-Payload.
Tools
analyze_package_change
Analysiert ein einzelnes Paket-Upgrade. Eingaben: ecosystem (npm oder pypi), name, fromVersion, toVersion.
analyze_packages_bulk
Analysiert bis zu 50 Paket-Upgrades parallel. Gibt die Pakete nach Risiko sortiert zurück (security > caution > review > likly-safe > safe) plus zusammenfassende Zählwerte.
Was Sie zurückerhalten
Semver-Klassifikation — major / minor / patch / downgrade / unknown
Breaking Changes — extrahiert aus den Überschriften der GitHub-Release-Notizen
Sicherheitskorrekturen — CVEs, die in
fromVersionvorhanden, aber intoVersionbehoben sind (über OSV.dev)Migrationslinks — Upgrade-Guide-URLs aus den Release-Notizen
Empfehlung — einzeilige Bewertung + Stufe
Unterstützte Ökosysteme
npm
PyPI
Entwicklung
npm install
npm run build
GITHUB_TOKEN=ghp_xxx npm run inspect # MCP InspectorLizenz
MIT
Available Tools
2 toolsanalyze_package_changeAnalyze a single dependency version changeARead-onlyIdempotentInspect
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.
Inputs: name (required), ecosystem (required), toVersion (required), fromVersion (required). Returns: package, repoUrl, ecosystem, toVersion, +9 more
analyze_packages_bulkAnalyze multiple dependency changes in parallelARead-onlyIdempotentInspect
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).
Inputs: changes (required). Returns: packages, bySemverClass, totalPackages, securityFixesTotal, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools are clearly separated by scope: one handles a single package upgrade, the other handles multiple packages in bulk. Each description explicitly references the other, so an agent can unambiguously choose based on input size.
Both tools follow the same analyze_package_* pattern, with the singular 'change' and plural 'bulk' clearly differentiating them. This is a consistent and predictable verb_noun convention.
Two tools is minimal, but the server's narrow purpose of dependency upgrade analysis is well served by one individual and one bulk entry point. It is slightly thin but not unreasonable for the domain.
The pair covers both single-package and multi-package analysis, which covers most workflows. A minor gap is the lack of direct lockfile/diff parsing, but users can supply the package list from those sources.
Maintenance
Related MCP Connectors
Check PyPI and npm upgrades: known vulnerabilities, the safe version, and what each upgrade breaks.
Check exact npm/PyPI upgrades for evidence-backed breaking changes; query APIs and components.
Diff two npm/PyPI versions or lockfiles: new install scripts, network/shell/eval calls, new deps.
Deterministic package.json upgrade plans: age gate, aligned peers, reasons per change. No AI.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides breaking changes analysis for libraries across multiple languages, enabling version upgrade planning, dependency audits, and migration reports through MCP tool access and expert workflows.-
- AlicenseNot gradedqualityCmaintenanceAnalyzes npm dependency upgrades to reveal which files and functions in your codebase break, with confidence tiers and transitive call chain tracing.5 npmMIT

@4da/mcp-serverofficial
AlicenseAqualityBmaintenanceEnables AI coding agents to learn, from locally read lockfiles, what changes between the dependency version installed and a target version, which of the user's files that upgrade touches, and which vulnerabilities it resolves. It also performs OSV-matched vulnerability scans, ranks upgrade plans, and stores decision memory, running entirely on the user's machine with no account or API keys.11508 npmApache 2.0- AlicenseAqualityBmaintenanceEnables AI coding agents to ground dependency setup, compatibility checks, and major-version migration advice in a project's real runtime, lockfiles, and config files. It parses local project state and npm registry metadata deterministically, then returns tag-pinned install commands, breaking changes, and upgrade steps rather than generic documentation.521 npmMIT