MCP server that translates a lockfile diff into a human-readable upgrade plan.
Point your AI assistant (Cursor, Claude Desktop, Claude Code) at a Dependabot PR, npm outdated output, or any pair of package versions, and get back a ranked upgrade plan: semver class, breaking changes pulled from GitHub release notes, CVEs fixed in the range, migration guide links, and a clear recommendation per package.
Translates a lockfile diff into a human-readable upgrade plan for npm, PyPI, and GitHub Actions.
Última comprobación
2026-11-09
Estrellas
—
Herramientas
—
Disponibilidad
—
What it looks like
Ask your assistant, in plain language:
Is it safe to bump lodash from 4.17.20 to 4.17.21?
The hosted instance authenticates to GitHub with its own token, so release-note lookups work at full rate limits without you configuring anything. Pass ?githubToken=ghp_xxx on the URL only if you would rather requests counted against your own GitHub quota. It is stateless and keeps no logs of your queries — see PRIVACY.md. Run the npm package locally instead if you would rather your token never leave your machine.
The same instance is also listed on Smithery, which proxies to it through their gateway.
GitHub token (optional but recommended)
The server hits the GitHub API to read release notes. Without a token you get 60 requests per hour (GitHub's anonymous limit) — enough for occasional single-package queries, not enough for bulk lockfile analysis.
The server resolves a token in this order:
GITHUB_TOKEN environment variable, if set.
gh auth token — if the GitHub CLI is installed and authenticated, the server uses that token automatically. No config change needed.
Anonymous (60 req/hr).
Recommended: use the gh CLI
If you already have gh installed (brew install gh && gh auth login), stop here — the server picks up your existing auth. No plaintext token anywhere.
This config file lives on your disk in plaintext. Keep perms tight (chmod 600) and do not paste the token into AI chats, issues, or shared screens — transcripts are often retained.
The token in this config should be least-privilege (public repo read only). Even leaked, it can only read public data you could already read.
The server never writes the token to stdout/stderr or the response payload.
Tools
analyze_package_change
Analyze one package upgrade. Inputs: ecosystem (npm, pypi, or github-actions), name, fromVersion, toVersion.
analyze_packages_bulk
Analyze up to 50 package upgrades in parallel. Returns packages ranked by risk (security > caution > review > likely-safe > safe), plus summary counts.
What you get back
Semver classification — major / minor / patch / downgrade / unknown
Breaking changes — extracted from GitHub release notes headers
Security fixes — CVEs present at fromVersion but resolved at toVersion (via OSV.dev)
Migration links — upgrade guide URLs found in release notes
Recommendation — single-line verdict + level
Both tools return this twice: as the JSON text block shown above, and as MCP
structured content
validated against a declared outputSchema. A client that supports structured output can read
recommendationLevel or securityFixes[] straight off the response instead of re-parsing the text.
Clients that don't are unaffected — the text block is unchanged.
Supported ecosystems
npm
PyPI
GitHub Actions — pass the action reference as the name (actions/checkout, or a nested github/codeql-action/init). An action reference is already a repository coordinate, so release notes and breaking changes resolve without a registry lookup, and bare major tags such as 4 -> 5 classify correctly.
Development
npm install
npm run build
GITHUB_TOKEN=ghp_xxx npm run inspect # MCP Inspector
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo Dep Diff?
Copia en esta página la configuración http para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿Dep Diff necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa Dep Diff?
Se accede a Dep Diff por HTTP.
¿Cuándo se comprobó Dep Diff por última vez?
Última comprobación: 2026-11-09. Translates a lockfile diff into a human-readable upgrade plan for npm, PyPI, and GitHub Actions.