Skip to main content
Glama

dep-diff-mcp

MCP 서버로, lockfile diff를 사람이 읽을 수 있는업그레이드 계획으로 변환합니다.

Cursor, Claude Desktop, Claude Code 같은 AI 어시스턴트에 Dependabot PR이나 npm outdated 출력, 또는 임의의 패키지 버전 쌍을 지정하면, 순위가 매겨진 업그레이드 계획을 돌려받습니다. semver 클래스, GitHub 릴리스 노트에서 뽑은 breaking changes, 해당 범위에서 수정된 CVE, 마이그레이션 가이드 링크, 그리고 패키지별 명확한 권장 사항입니다.

Install

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 list

서버를 적영하려면 Claude Code 세션을 renamed 시작하세요.

Cursor and Claude Desktop

MCP 클라이언트 설정에 추가하세요:

  • Cursor: ~/.cursor/mcp.json

  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %AAPPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "dep-diff": {
      "command": "npx",
      "args": ["-y", "@digicatalyst/dep-diff-mcp"]
    }
  }
}

MCP 클라이언트를 다시 시작하세요. "이 Dependabot PR에서 무잇 위험한가요?" 같은 질문을 하면 도구가 자동으록 호장됩니다.

Hosted remote (no install)

호스트된 인스턴스가 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를 호출합니다. 토큰 없이 제공하면 시간당 60회(GitHub의 익명 한도) — 가끔 싶글 패키지 질의에는 충분하지만, 대규모 lockfile 분석에는 부족합니다.

서버는 다음과 같은 순서로 토큰을 확인합니다:

  1. GITHUB_TOKEN 환경 변수(설정된 경우)

  2. gh auth token — GitHub CLI가 설치되고 인증되어 있으면 서버가 자동으로 해당 토큰을 사용합니다. 설정 변경이 필요 없습니다.

  3. 익명 (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 채팅, 이슈, 공유 화면에 토큰을 붙여넣지 마세요 — 대화 기록이 계속 유지되는 경우가 많습니다.

  • 이 설정의 토큰은 최소 권한(공개 저장소 읽기 전용)이어야 합니다. 유출되더라도 이미 읽을 수 있는 공개 데이터만 읽을 수 있습니다.

  • 토큰을 주기적으로 순환하세요. 외부에 노출되었을 수 있는 토큰은 https://github.com/settings/tokens에서 해지하세요.

  • 서버는 토큰을 stdout/stderr 또는 응답 페이로드에 기록하지 않습니다.

도구

analyze_package_change

하나의 패키지 업그레이드를 분석합니다. 입력: ecosystem(npm 또는 pypi), name, fromVersion, toVersion.

analyze_packages_bulk

최대 50개의 패키지 업그레이드를 병렬로 분석합니다. 위험 순으로 정렬된 패키지(security > caution > review > likely-safe > safe)와 함게 요약 개수를 반환합니다.

돌려받는 붂

  • Semver 분류 — major / minore / patch / downgrade / unknown

  • Breaking changes — GitHub 릴리스 노트 머리말들에서 추출

  • Security fixes — fromVersion에 존재하지만 toVersion에서 해결된 CVE (via OSV.dev)

  • 마이그레이션 링크 — 릴리스 노트에서 찾은 업그레이드 가이드 URL

  • 권장 사항 — 한 줄 평결 + 등급

지원되는 에cosystem

  • npm

  • PyPI

개발

npm install
npm run build
GITHUB_TOKEN=ghp_xxx npm run inspect   # MCP Inspector

라이선스

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