Skip to main content
Glama

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-mcp

A 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-mcp

Con 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-mcp

Verifica:

claude mcp list

Reinicia 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.json

  • Claude 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/mcp

O 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:

  1. La variable de entorno GITHUB_TOKEN, si está definida.

  2. 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.

  3. 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-mcp

  • Caducidad: 90 días (rota periódicamente)

  • Acceso a repositorios: Public Repositories (read-only) — sin acceso a repositorios privados

  • Permisos: nada más que la lectura pública predeterminada; no otorgues repo, workflow, user ni 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 fromVersion pero resueltos en toVersion (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 Inspector

Licencia

MIT

Available Tools

2 tools
analyze_package_changeAnalyze a single dependency version changeA
Read-onlyIdempotent
Inspect

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 parallelA
Read-onlyIdempotent
Inspect

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

    A4.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      11
      508 npm
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      5
      21 npm
      MIT