dep-diff-mcp
dep-diff-mcp
ロックファイルの差分を、人間が読めるアップグレード計画に変換するMCPサーバーです。
AI アシスタント(Cursor、Claude Desktop、Claude Code)を Dependabot プレリクエスト、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明示的なトークンを指定する場合(gh CLI で認証済みの場合はこの手順はスキップしてください — GitHubトークン を参照):
claude mcp add -s user --env GITHUB_TOKEN=ghp_xxx dep-diff -- npx -y @digicatalyst/dep-diff-mcp確認:
claude mcp listClaude 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 のストリーミング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"
}
}
}レート制限を上げたい場合は、URL に ?githubToken=ghp_xxx を付けて GitHub トークンを渡します。ホスト型インスタンスはステートレスで、クエリのログを一切残しません — PRIVACY.md を参照してください。自分のマシンからトークンを出したくない場合は、代わりに npm パッケージをローカルで実行してください。
Related MCP server: blastradius
GitHubトークン(オプションだが推奨)
サーバーは GitHub API にアクセスしてリリースノートを読み取ります。トークンなしだと、1時間あたり60リクエスト(GitHub の匿名制限)を受けられます。単発のパッケージ検索には十分ですが、ロックファイル全体の一括分析には不十分です。
サーバーは次の順序でトークンを解決します:
GITHUB_TOKEN環境変数(設定されている場合)。gh auth token— GitHub CLI がインストールされ認証済みであれば、サーバーはそのトークンを自動的に使用します。設定の変更は不要です。匿名(60リクエスト/時)。
推奨:gh CLI を使用する
gh をすでにインストールしている(brew install gh && gh auth login)なら、ここで終了です。サーバーが既存の認証を自動的に使用します。平文のトークンはどこにもありません。
代替案:環境変数
https://github.com/settings/tokens で 細粒度(fine-grained) トークンを作成します:
トークン名:
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 チャットや issue、共有画面に貼り付けないでください。会話ログは残ることが多いためです。この設定のトークンは最小権限(公開リポジトリの読み取り専用)にします。万一漏れても、すでに読み取れる公開データのみを読み取れます。
トークンは定期的にローテーションしてください。露出した可能性のあるトークンは、https://github.com/settings/tokens で失効させてください。
サーバーはトークンを stdout/stderr やレスポンスのペイロードに書き出すことは決してありません。
ツール
analyze_package_change
1つのパッケージアップグレードを分析します。入力:ecosystem(npm または pypi)、name、fromVersion、toVersion。
analyze_packages_bulk
最大50件のパッケージアップグレードを並列に分析します。リスク順にランク付けされたパッケージ(security > caution > review > likely-safe > safe)と、要約カウントを返します。
受け取れる結果
Semver 区分 — major / minor / patch / downgrade / unknown
破壊的変更 — GitHub リリースノートの見出しから抽出
セキュリティ修正 —
fromVersionに存在し、toVersionで修正済みのCVE(OSV.dev 経由)移行ガイドリンク — リリースノート内で見つかったアップグレードガイドのURL
推奨事項 — 1行の判定 + レベル
サポート対象エコシステム
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