dep-diff-mcp
dep-diff-mcp
MCP-сервер, который превращает дифф lock-файла в читаемый план обновления пакетов.
Направьте своего ИИ-ассистента (Cursor, Claude Desktop, Claude Code) на Dependabot PR, на вывод npm outdated или на любую пару версий пакетов — и получите ранжированный план обновления: класс semver, ломающие изменения из релизных заметок GitHub, CVE, исправленные в диапазоне версий, ссылки на руководства по миграции и чёткую рекомендацию по каждому пакету.
Установка
Claude Code
Одна команда — на уровне пользователя (доступно в каждом проекте):
claude mcp add -s user dep-diff -- npx -y @digicatalyst/dep-diff-mcpНа уровне проекта (записывает .mcp.json в корень репозитория, общий для команды):
claude mcp add -s project dep-diff -- npx -y @digicatalyst/dep-diff-mcpС явным токеном (пропустите этот шаг, если CLI gh уже авторизован — см. Токен GitHub ниже):
claude mcp add -s user --env GITHUB_TOKEN=ghp_xxx dep-diff -- npx -y @digicatalyst/dep-diff-mcpПроверка:
claude mcp listПерезапустите сессию Claude Code, чтобы сервер подхватился.
Cursor и Claude Desktop
Добавьте в конфигурацию вашего MCP-клиента:
Cursor:
~/.cursor/mcp.jsonClaude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS) или%APPDATA%\Claude\claude_desktop_config.json(Windows)
{
"mcpServers": {
"dep-diff": {
"command": "npx",
"args": ["-y", "@digicatalyst/dep-diff-mcp"]
}
}
}Перезапустите MCP-клиента. Спросите что-то вроде «что тут рискованного в этом Dependabot PR?» — и инструменты будут вызваны автоматически.
Облачная версия (без установки)
Размещённый экземпляр работает по адресу https://dep-diff.digicatalyst.ca/mcp по протоколу streamable HTTP, так что от пакета npm можно полностью отказаться:
claude mcp add -s user -t http dep-diff https://dep-diff.digicatalyst.ca/mcpИли в конфигурации клиента:
{
"mcpServers": {
"dep-diff": {
"type": "http",
"url": "https://dep-diff.digicatalyst.ca/mcp"
}
}
}Если нужны более высокие лимиты запросов, передайте токен GitHub в URL с параметром ?githubToken=ghp_xxx. Размещённый экземпляр не сохраняет состояние и не ведёт логи ваших запросов — см. PRIVACY.md. Если вы предпочитаете, чтобы токен никогда не покидал вашу машину, запускайте пакет npm локально.
Related MCP server: blastradius
Токен GitHub (необязательно, но рекомендуется)
Сервер обращается к GitHub API, чтобы читать релизные заметки. Без токена доступно 60 запросов в час (анонимный лимит GitHub) — этого достаточно для отдельных запросов по одному пакету, но недостаточно для массового анализа lock-файла.
Сервер определяет токен в следующем порядке:
Переменная окружения
GITHUB_TOKEN, если она задана.gh auth token— если GitHub CLI установлен и авторизован, сервер использует этот токен автоматически. Изменять конфигурацию не нужно.Анонимный доступ (60 запросов/час).
Рекомендуемый способ: используйте CLI gh
Если у вас уже установлен gh (brew install gh && gh auth login), на этом можно остановиться — сервер сам подхватит вашу текущую авторизацию. Токен нигде не хранится в открытом виде.
Альтернативный вариант: переменная окружения
Создайте fine-grained токен на странице https://github.com/settings/tokens:
Имя токена:
dep-diff-mcpСрок действия: 90 дней (периодически перевыпускайте)
Доступ к репозиториям:
Public Repositories (read-only)— без доступа к приватным репозиториямРазрешения: только публичное чтение по умолчанию — не выдавайте области
repo,workflow,userили любые другие разрешения на запись
Затем укажите токен в конфигурации MCP:
{
"mcpServers": {
"dep-diff": {
"command": "npx",
"args": ["-y", "@digicatalyst/dep-diff-mcp"],
"env": { "GITHUB_TOKEN": "github_pat_xxx" }
}
}
}Примечания о безопасности
Этот конфигурационный файл хранится на вашем диске в открытом виде. Держите права доступа жёсткими (
chmod 600) и не вставляйте токен в AI-чаты, issues или общие демонстрации экрана — записи таких сессий часто сохраняются.Токен в конфиге должен иметь наименьшие привилегии (только чтение публичных репозиториев). Даже при утечке он сможет прочитать только те публичные данные, которые вы и так можете прочитать.
Периодически перевыпускайте токены. Отзывайте любой токен, который мог быть раскрыт, на https://github.com/settings/tokens.
Сервер никогда не выводит токен в stdout/stderr и не включает его в ответ (response payload).
Инструменты
analyze_package_change
Анализирует обновление одного пакета. Входные данные: ecosystem (npm или pypi), name, fromVersion, toVersion.
analyze_packages_bulk
Анализирует до 50 обновлений пакетов параллельно. Возвращает пакеты, отсортированные по уровню риска (security > caution > review > likely-safe > safe), плюс сводные счётчики по категориям.
Что вы получаете в ответ
Классификация semver — major / minor / patch / downgrade / unknown
Ломающие изменения — извлечённые из заголовков релизных заметок GitHub
Исправления безопасности — CVE, присутствующие в
fromVersion, но устранённые вtoVersion(через OSV)Ссылки для миграции — URL руководств по обновлению, найденные в релизных заметках
Рекомендация — вердикт в одну строку + уровень риска
Поддерживаемые экосистемы
npm
PyPI
Разработка
npm install
npm run build
GITHUB_TOKEN=ghp_xxx npm run inspect # MCP InspectorЛицензия
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