{
  "markdown": "# dependency-migration-mcp\n\n<!-- mcp-name: io.github.SolvoHQ/dependency-migration-mcp -->\n\n**Through-the-upgrade migration briefs for LLM coding agents.**\n\nOfficial codemods auto-apply the mechanical ~90% of a major version bump.\nThis MCP server briefs your agent on the **non-mechanical ~10% that still\nleaves the build red**, and corrects the agent's **stale-v3-training\nhallucination** of the old API surface — the part a codemod cannot do.\n\nFor one `(package, from, to)` triple it returns a structured brief: per\nbreaking change — category, before/after, how to grep every occurrence in\n*your* code, the fix, and whether the free codemod already covers it — plus a\ntop-level list of the specific old-API hallucinations the agent must suppress.\n\n## Supported matrix\n\n| package       | from → to | tier | source |\n|---------------|-----------|------|--------|\n| `tailwindcss` | 3 → 4     | **flagship — verified** against the upstream upgrade guide (2026-05-16) | https://tailwindcss.com/docs/upgrade-guide |\n| `next`        | 14 → 15   | reasonable-accuracy | https://nextjs.org/docs/app/guides/upgrading/version-15 |\n| `react`       | 18 → 19   | reasonable-accuracy | https://react.dev/blog/2024/04/25/react-19-upgrade-guide |\n\nVersions are normalised by major (`3`, `3.4.1`, `v3`, `^3` → `3`). An unknown\npackage or unsupported pair returns a clean structured `not_found` (with the\nsupported matrix) — never an exception. Data is hand-curated and offline (no\nruntime network calls).\n\n## Install (one command, zero account)\n\n```bash\nuvx --from git+https://github.com/SolvoHQ/dependency-migration-mcp dependency-migration-mcp\n```\n\nThat fetches, builds, and runs the stdio MCP server straight from public\nGitHub. No clone, no signup, no API key. (Need `uvx`? `pip install uv`.)\n\nPrefer pip? A venv fallback:\n\n```bash\npython3 -m venv .venv && . .venv/bin/activate\npip install \"git+https://github.com/SolvoHQ/dependency-migration-mcp.git\"\ndependency-migration-mcp        # runs the stdio server\n```\n\n## Wire it into your agent\n\n**Claude Code** — `claude mcp add`:\n\n```bash\nclaude mcp add dependency-migration -- uvx --from git+https://github.com/SolvoHQ/dependency-migration-mcp dependency-migration-mcp\n```\n\nor drop this into `.mcp.json` at your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"dependency-migration\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/SolvoHQ/dependency-migration-mcp\",\n        \"dependency-migration-mcp\"\n      ]\n    }\n  }\n}\n```\n\n**Cursor** — `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"dependency-migration\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/SolvoHQ/dependency-migration-mcp\",\n        \"dependency-migration-mcp\"\n      ]\n    }\n  }\n}\n```\n\n## Tool\n\n`get_migration(package: str, from_version: str, to_version: str) -> dict`\n\nRead-only. Returns a JSON-able brief: `summary` (counts, codemod command +\nwhat it does/doesn't cover, `stale_training_hallucination_warnings`,\npositioning) and `breaking_changes[]` (each with `id`, `title`, `category`\n∈ `{mechanical, non-mechanical, behavioural, removed-api, config-shape}`,\n`what_changed.{description,before,after}`,\n`find_occurrences.{guidance,patterns}`, `fix`, `codemod_covered`, and\n`codemod_command` when covered).\n\nUse it mid-upgrade: right after bumping a major version and seeing the build\ngo red, ask the agent to call `get_migration` before it starts editing.\n\n## Smoke test\n\n```bash\npip install -r requirements.txt          # mcp>=1.2, pydantic>=2  (Python 3.10+)\npython smoke_test.py\n```\n\nImports the server, calls `get_migration(\"tailwindcss\",\"3\",\"4\")` and asserts\nthe `@tailwind`→`@import` change, the CSS-first config-shape change, and a\nstale-training hallucination warning are present; then asserts an unknown\npair returns a clean `not_found`.\n",
  "bytes": 3849,
  "sha": "b68f0206c9bae4f8462f0382078ca7c9e120965fb768b925b62b66ad8a4506aa",
  "repo_slug": "solvohq/dependency-migration-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_solvohq_dependency_migration_m_f708c624/readme"
}