dep-diff-mcp
dep-diff-mcp
Servidor MCP que convierte el diff de un lockfile en un plan de actualización legible para humanos.
Apunta tu asistente de IA (Cursor, Claude Desktop y Claude Code) a un PR de Dependabot, a la salida de npm outdated o a cualquier par de versiones de paquetes, y obtendrás un plan de actualización clasificado: clase semver, cambios incompatibles extraídos de las notas de lanzamiento de GitHub, CVEs corregidos en el rango, enlaces a guías de migración y una recomendación clara por paquete.
Instalación
Claude Code
Un solo comando, a nivel de usuario (disponible en todos los proyectos):
claude mcp add -s user dep-diff -- npx -y @digicatalyst/dep-diff-mcpA nivel de proyecto (escribe .mcp.json en la raíz del repositorio, compartido con el equipo):
claude mcp add -s project dep-diff -- npx -y @digicatalyst/dep-diff-mcpCon un token explícito (sáltate este paso si tienes la CLI de gh autenticada; consulta Token de GitHub más abajo):
claude mcp add -s user --env GITHUB_TOKEN=ghp_xxx dep-diff -- npx -y @digicatalyst/dep-diff-mcpVerifica:
claude mcp listReinicia la sesión de Claude Code para que el servidor se cargue.
Cursor y Claude Desktop
Añade la entrada a la configuración de tu cliente MCP:
Cursor:
~/.cursor/mcp.jsonClaude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS) o%APPDATA%\Claude\claude_desktop_config.json(Windows)
{
"mcpServers": {
"dep-diff": {
"command": "npx",
"args": ["-y", "@digicatalyst/dep-diff-mcp"]
}
}
}Reinicia tu cliente MCP. Pregunta algo así como "¿qué hay de arriesgado en este PR de Dependabot?" y las herramientas se invocan automáticamente.
Instancia alojada (sin instalación)
Una instancia alojada se ejecuta en https://dep-diff.digicatalyst.ca/mcp sobre HTTP streamable, de modo que puedes omitir por completo el paquete npm:
claude mcp add -s user -t http dep-diff https://dep-diff.digicatalyst.ca/mcpO en la configuración de un cliente:
{
"mcpServers": {
"dep-diff": {
"type": "http",
"url": "https://dep-diff.digicatalyst.ca/mcp"
}
}
}Pasa un token de GitHub con el parámetro ?githubToken=ghp_xxx en la URL si quieres límites de solicitudes más altos. La instancia alojada no mantiene estado y no guarda registros de tus consultas; consulta PRIVACY.md. Ejecuta el paquete npm de forma local si prefieres que tu token nunca salga de tu máquina.
Related MCP server: blastradius
Token de GitHub (opcional pero recomendado)
El servidor consulta la API de GitHub para leer las notas de lanzamiento. Sin un token disponible, obtienes 60 solicitudes por hora (el límite anónimo de GitHub), suficiente para consultas ocasionales de un solo paquete, pero no para un análisis masivo de lockfiles.
El servidor determina el token en este orden:
La variable de entorno
GITHUB_TOKEN, si está definida.gh auth token— si la GitHub CLI está instalada y autenticada, el servidor usa ese token automáticamente. No se necesita cambiar ninguna configuración.Anónimo (60 solicitudes por hora).
Recomendado: usar la CLI de gh
Si ya tienes gh instalado (brew install gh && gh auth login), detente aquí: el servidor recoge tu autenticación existente. No hay ningún token en texto plano en ningún sitio.
Alternativa: variable de entorno
Crea un token de granularidad fina en https://github.com/settings/tokens:
Nombre del token:
dep-diff-mcpCaducidad: 90 días (rota periódicamente)
Acceso a repositorios:
Public Repositories (read-only)— sin acceso a repositorios privadosPermisos: nada más que la lectura pública predeterminada; no otorgues
repo,workflow,userni ningún permiso de escritura.
Luego, haz referencia a él en la configuración de MCP:
{
"mcpServers": {
"dep-diff": {
"command": "npx",
"args": ["-y", "@digicatalyst/dep-diff-mcp"],
"env": { "GITHUB_TOKEN": "github_pat_xxx" }
}
}
}Notas de seguridad
Este archivo de configuración vive en tu disco en texto plano. Mantén los permisos estrictos (chmod 600) y no pegues el token en chats de IA, issues ni pantallas compartidas; las transcripciones suelen conservarse.
El token de esta configuración debe tener el mínimo privilegio (solo lectura de repositorios públicos). Incluso si se filtra, solo puede leer datos públicos que ya podías leer.
Rota los tokens periódicamente. Revoca cualquier token que pueda haberse expuesto en https://github.com/settings/tokens.
El servidor nunca escribe el token en stdout/stderr ni en la carga útil de la respuesta.
Herramientas
analyze_package_change
Analiza un cambio en un paquete. Parámetros: ecosystem (npm o pypi), name, fromVersion, toVersion.
analyze_packages_bulk
Analiza hasta 50 actualizaciones de paquetes en paralelo. Devuelve los paquetes clasificados por riesgo (security > caution > review > likely-safe > safe), además de recuentos resumen.
Qué obtienes
Clasificación semver — major / minor / patch / downgrade / unknown
Cambios incompatibles — extraídos de los encabezados de las notas de lanzamiento de GitHub
Correcciones de seguridad — CVEs presentes en
fromVersionpero resueltos entoVersion(según OSV.dev)Enlaces de migración — URL de guías de actualización encontradas en las notas de lanzamiento
Recomendación — veredicto en una línea + nivel
Ecosistemas compatibles
npm
PyPI
Desarrollo
npm install
npm run build
GITHUB_TOKEN=ghp_xxx npm run inspect # MCP InspectorLicencia
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