mcp-use-compat 0.3.0

package/dist/upgrade.js

@@ -0,0 +1,115 @@
+import { spawn } from "node:child_process";
+import { readFileSync, writeFileSync } from "node:fs";
+import { connect } from "./connect/index.js";
+import { diffSnapshots } from "./diff.js";
+import { detectProject, lookupLatest } from "./project.js";
+import { cell } from "./reporters/escape.js";
+import { adviseUpgrade, SDK_FACTS } from "./sdk-facts.js";
+export function renderAdvice(project, advice) {
+    const lines = [`# MCP SDK upgrades: ${project.dir}`, "", "| SDK | Installed | Latest | Status | Command |", "|---|---|---|---|---|"];
+    for (const a of advice) {
+        const status = { current: "✅ latest", minor: "⬆️ update", major: "⚠️ major update", migrate: "➡️ migrate for 2026-07-28", unknown: "? unknown" }[a.kind];
+        lines.push(`| ${a.sdk.name} | ${a.sdk.installed ?? a.sdk.declared ?? "?"} | ${a.sdk.latest ?? "?"} | ${status} | ${a.command && a.kind !== "current" ? `\`${cell(a.command)}\`` : ""} |`);
+    }
+    lines.push("");
+    for (const a of advice) {
+        const fact = SDK_FACTS[a.sdk.name];
+        if (a.kind !== "current" || fact?.migrateTo)
+            lines.push(`- ${a.summary}${fact?.note && a.kind !== "migrate" ? ` ${fact.note}` : ""}`);
+    }
+    return lines.join("\n") + "\n";
+}
+/** Which upgrades --apply runs: minor always, major only with --major, never migrations. */
+export function planUpgrades(advice, allowMajor) {
+    return advice.filter((a) => a.command && (a.kind === "minor" || (a.kind === "major" && allowMajor)));
+}
+/** Rewrites `name==old` to `name==new` in a pinned requirements file. */
+export function bumpPin(file, name, version) {
+    const text = readFileSync(file, "utf8");
+    const re = new RegExp(`^(\\s*${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?:\\[[^\\]]*\\])?\\s*==\\s*)[^\\s;#]+`, "im");
+    if (!re.test(text))
+        return false;
+    writeFileSync(file, text.replace(re, `$1${version}`));
+    return true;
+}
+/** Runs each upgrade in order and bumps == pins; stops at the first failure. */
+export async function applyPlan(plan, dir, run, log) {
+    for (const a of plan) {
+        log(`\n$ ${a.command}`);
+        const code = await run(a.command, dir);
+        if (code !== 0) {
+            log(`✖ Upgrade of ${a.sdk.name} failed (exit ${code}). Nothing else was changed after this point.`);
+            return false;
+        }
+        if (a.pinnedFile && a.sdk.latest) {
+            log(bumpPin(a.pinnedFile, a.sdk.name, a.sdk.latest)
+                ? `Updated the pin in ${a.pinnedFile} to ${a.sdk.name}==${a.sdk.latest}.`
+                : `Couldn't update the pin in ${a.pinnedFile}; edit it by hand.`);
+        }
+    }
+    return true;
+}
+function runShell(command, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(command, { cwd, shell: true, stdio: "inherit" });
+        child.on("close", (code) => resolve(code ?? 1));
+        child.on("error", () => resolve(1));
+    });
+}
+function protocolOf(s) {
+    if (!s.connect.ok)
+        return "not connecting";
+    const modern = s.modern?.supported ? " + 2026-07-28" : "";
+    return `${s.initialize?.negotiatedProtocolVersion ?? "?"}${s.era === "modern" ? " (2026-07-28 only)" : modern}`;
+}
+export async function runUpgrade(options, log = (m) => console.error(m)) {
+    const target = options.target;
+    const project = target?.kind === "stdio" ? detectProject(target.command, target.args, target.cwd) : detectProject("", [], options.dir);
+    if (!project) {
+        log(`No MCP SDK found in ${target?.kind === "stdio" ? target.cwd : options.dir} or its parents (looked for package.json, pyproject.toml, requirements.txt, go.mod, Cargo.toml).`);
+        return 2;
+    }
+    if (!options.offline)
+        await lookupLatest(project.sdks);
+    const advice = project.sdks.map(adviseUpgrade);
+    process.stdout.write(renderAdvice(project, advice));
+    if (!options.apply) {
+        const recheck = target ? " and re-check the server before and after" : "";
+        if (planUpgrades(advice, options.major).length) {
+            log(`\nRun with --apply to perform ${planUpgrades(advice, options.major).length === 1 ? "this upgrade" : "these upgrades"}${recheck}.`);
+        }
+        else if (planUpgrades(advice, true).length) {
+            log(`\nRun with --apply --major to perform the major upgrade${recheck} (read the release notes first).`);
+        }
+        return 0;
+    }
+    const plan = planUpgrades(advice, options.major);
+    const skippedMajor = advice.filter((a) => a.kind === "major" && !options.major);
+    if (skippedMajor.length)
+        log(`Skipping major upgrade(s) of ${skippedMajor.map((a) => a.sdk.name).join(", ")}; pass --major to include them.`);
+    if (plan.length === 0) {
+        log("Nothing to apply.");
+        return 0;
+    }
+    const check = (label) => target ? (log(`\nChecking the server ${label} upgrading...`), connect({ target, timeoutMs: options.timeoutMs, authProbe: false, offline: true })) : undefined;
+    const before = await check("before");
+    if (!(await applyPlan(plan, project.dir, options.run ?? runShell, log)))
+        return 1;
+    const after = await check("after");
+    if (!before || !after) {
+        log("\n✔ Upgraded. Pass the server command after -- to re-check it automatically.");
+        return 0;
+    }
+    log(`\nProtocol: ${protocolOf(before)} → ${protocolOf(after)}`);
+    if (!after.connect.ok) {
+        log(`✖ The server no longer starts after the upgrade: ${after.connect.error}. Review the changes (e.g. git diff) or roll back.`);
+        return 1;
+    }
+    const changes = diffSnapshots(before, after);
+    const breaking = changes.filter((c) => c.level === "breaking");
+    for (const c of changes)
+        log(`  ${c.level.padEnd(8)} ${c.kind}: ${c.subject}: ${c.message}`);
+    log(breaking.length ? `\n✖ ${breaking.length} breaking change(s) after the upgrade; review them before shipping.` : `\n✔ Upgrade done; no breaking changes to the server's MCP surface.`);
+    return breaking.length ? 1 : 0;
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare const TOOL_NAME: string;
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,SAAS,QAAW,CAAC;AAClC,eAAO,MAAM,OAAO,QAAc,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+import { readFileSync } from "node:fs";
+const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+export const TOOL_NAME = pkg.name;
+export const VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC7B,CAAC;AAEvC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;AAClC,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "mcp-use-compat",
+  "version": "0.3.0",
+  "description": "Find the problems that break an MCP server in specific MCP clients (Claude, ChatGPT, Cursor, VS Code, Codex and more), with sourced client facts, SDK upgrade help and CI output.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "compatibility",
+    "lint",
+    "testing",
+    "claude",
+    "chatgpt",
+    "cursor",
+    "vscode",
+    "codex",
+    "ci"
+  ],
+  "homepage": "https://github.com/VrajVed/mcp-use-compat#readme",
+  "bugs": {
+    "url": "https://github.com/VrajVed/mcp-use-compat/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VrajVed/mcp-use-compat.git"
+  },
+  "license": "MIT",
+  "author": "VrajVed",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "mcp-use-compat": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p .",
+    "dev": "tsc -p . --watch",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "test": "node --import tsx --test \"test/**/*.test.ts\"",
+    "prepack": "npm run build",
+    "readme": "tsx scripts/readme.ts",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.1",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "commander": "^12.0.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.23.15",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/schema/report.schema.json

@@ -0,0 +1,327 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/VrajVed/mcp-use-compat/schema/report.schema.json",
+  "title": "mcp-use-compat report",
+  "description": "Output of `mcp-use-compat --format json`. schemaVersion changes only on breaking changes.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "tool",
+    "generatedAt",
+    "target",
+    "server",
+    "checks",
+    "findings",
+    "clients"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "tool": {
+      "type": "object",
+      "required": [
+        "name",
+        "version"
+      ],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        }
+      }
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "target": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "kind",
+            "command",
+            "args",
+            "cwd"
+          ],
+          "properties": {
+            "kind": {
+              "const": "stdio"
+            },
+            "command": {
+              "type": "string"
+            },
+            "args": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "cwd": {
+              "type": "string"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "kind",
+            "url"
+          ],
+          "properties": {
+            "kind": {
+              "const": "http"
+            },
+            "url": {
+              "type": "string"
+            }
+          }
+        }
+      ]
+    },
+    "server": {
+      "type": "object",
+      "required": [
+        "connected",
+        "era",
+        "counts"
+      ],
+      "properties": {
+        "connected": {
+          "type": "boolean"
+        },
+        "name": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        },
+        "protocolVersion": {
+          "type": "string"
+        },
+        "counts": {
+          "type": "object",
+          "required": [
+            "tools",
+            "resources",
+            "resourceTemplates",
+            "prompts"
+          ],
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "era": {
+          "enum": [
+            "legacy",
+            "modern",
+            "both"
+          ]
+        },
+        "versions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "version",
+              "ok"
+            ],
+            "properties": {
+              "version": {
+                "type": "string"
+              },
+              "ok": {
+                "type": "boolean"
+              },
+              "negotiated": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "checks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "area",
+          "description",
+          "ran"
+        ],
+        "properties": {
+          "id": {
+            "$ref": "#/$defs/checkId"
+          },
+          "area": {
+            "$ref": "#/$defs/area"
+          },
+          "description": {
+            "type": "string"
+          },
+          "ran": {
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/finding"
+      }
+    },
+    "clients": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "client",
+          "displayName",
+          "rows",
+          "summary"
+        ],
+        "properties": {
+          "client": {
+            "type": "string"
+          },
+          "displayName": {
+            "type": "string"
+          },
+          "rows": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/row"
+            }
+          },
+          "summary": {
+            "type": "object",
+            "required": [
+              "pass",
+              "warn",
+              "fail",
+              "info",
+              "skip"
+            ],
+            "additionalProperties": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "checkId": {
+      "type": "string",
+      "pattern": "^[A-Z]+(_[A-Z0-9]+)+$"
+    },
+    "area": {
+      "enum": [
+        "transport",
+        "protocol",
+        "tools",
+        "schema",
+        "discovery",
+        "resources",
+        "ui",
+        "auth",
+        "calls",
+        "sdk"
+      ]
+    },
+    "status": {
+      "enum": [
+        "pass",
+        "warn",
+        "fail",
+        "info",
+        "skip"
+      ]
+    },
+    "finding": {
+      "type": "object",
+      "required": [
+        "checkId",
+        "severity",
+        "message"
+      ],
+      "properties": {
+        "checkId": {
+          "$ref": "#/$defs/checkId"
+        },
+        "severity": {
+          "enum": [
+            "error",
+            "warn",
+            "info"
+          ]
+        },
+        "message": {
+          "type": "string"
+        },
+        "subject": {
+          "type": "string"
+        },
+        "evidence": {
+          "type": "object"
+        },
+        "fix": {
+          "type": "string"
+        },
+        "affects": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "client": {
+          "type": "string"
+        },
+        "source": {
+          "type": "string"
+        }
+      }
+    },
+    "row": {
+      "type": "object",
+      "required": [
+        "checkId",
+        "area",
+        "status",
+        "message"
+      ],
+      "properties": {
+        "checkId": {
+          "$ref": "#/$defs/checkId"
+        },
+        "area": {
+          "$ref": "#/$defs/area"
+        },
+        "status": {
+          "$ref": "#/$defs/status"
+        },
+        "message": {
+          "type": "string"
+        },
+        "subject": {
+          "type": "string"
+        },
+        "fix": {
+          "type": "string"
+        },
+        "source": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}