Parse, compare, range-check, and increment semver versions via @mukundakatta/semver-mcp (npx)

Recipe: Semver parse/compare/satisfy/increment via @mukundakatta/semver-mcp

Install & launch:

npm install @mukundakatta/semver-mcp
# Server entry: node node_modules/@mukundakatta/semver-mcp/index.js
# Transport: stdio

Tools (4):

inc release types: major, minor, patch, premajor, preminor, prepatch, prerelease. Optional: identifier for prerelease tag (e.g. "beta").

Example 1 — Parse a version with prerelease + build metadata:

// Request
{ "method": "tools/call", "params": { "name": "parse", "arguments": { "version": "3.14.2-beta.1+build.456" } } }

// Response (2ms)
{ "content": [{ "type": "text", "text": "{\"version\":\"3.14.2-beta.1\",\"major\":3,\"minor\":14,\"patch\":2,\"prerelease\":[\"beta\",1],\"build\":[\"build\",\"456\"]}" }] }

Example 2 — Compare two versions:

// Request
{ "method": "tools/call", "params": { "name": "compare", "arguments": { "a": "2.1.0", "b": "2.3.0" } } }

// Response (1ms) — a < b
{ "content": [{ "type": "text", "text": "{\"result\":-1}" }] }

Example 3 — Range satisfaction (caret range):

// Request
{ "method": "tools/call", "params": { "name": "satisfies", "arguments": { "version": "1.5.3", "range": "^1.4.0" } } }

// Response (2ms)
{ "content": [{ "type": "text", "text": "{\"satisfies\":true}" }] }

// Negative case: 4.0.0 vs ^3.0.0 → false (0ms)

Example 4 — Increment version:

// Request (minor bump)
{ "method": "tools/call", "params": { "name": "inc", "arguments": { "version": "1.2.3", "release": "minor" } } }
// Response (2ms): {"version":"1.3.0"}

// Request (prerelease with identifier)
{ "method": "tools/call", "params": { "name": "inc", "arguments": { "version": "2.0.0", "release": "prerelease", "identifier": "alpha" } } }
// Response (1ms): {"version":"2.0.1-alpha.0"}

Performance: 0-2ms per call. Server startup ~180ms cold.

When to use: checking if a dependency version is compatible before upgrade, sorting package versions, deciding whether to bump major/minor/patch in release automation, validating version strings in package.json or lockfiles.