Initial release of vdiff-mcp, an MCP server that gives coding agents structured
breaking-change diffs for npm packages, backed by the hosted vdiff API.
Tools
get_breaking_changes— structured diff of a package's public API between
two versions, computed from its TypeScript type declarations: removed exports,
changed signatures, removed or changed class/interface members, plus new
exports. Each entry includes before/after signatures and a short migration
note, and every response carries a confidence score (0.9 bundled types,
0.8 DefinitelyTyped@types/*).resolve_package— latest published version and dist-tags for a package.
Behavior
- Diffs are computed on demand and cached server-side permanently; the first
request for a version pair can take a minute or two, and the server polls
until it is ready (2-minute budget), so agents get a single tool call either way. - No API key or signup required.
VDIFF_API_URLenv var points the server at a self-hosted vdiff instance.
Install
claude mcp add vdiff -- npx -y vdiff-mcp
Or in any MCP client config:
{ "command": "npx", "args": ["-y", "vdiff-mcp"] }
Published on npm and the
official MCP registry as
io.github.mcurmi05/vdiff-mcp. Requires Node 20+. MIT licensed.