Skip to main content
Glama
rn-upgrade-helper-mcp

rn-upgrade-helper-mcp

rn-upgrade-helper-mcp

An MCP server for React Native Upgrade Helper diffs.

It fetches the same generated template diffs used by React Native Upgrade Helper, backed by react-native-community/rn-diff-purge, and exposes them as MCP tools that agents can call directly.

Tools

  • get_upgrade_helper_url: builds the web Upgrade Helper URL.

  • list_changed_files: returns structured changed-file metadata.

  • get_file_diff: returns the diff for one file.

  • get_upgrade_diff: returns the full diff, optionally filtered by android, ios, or js.

  • summarize_upgrade: summarizes changed areas and notable files.

Related MCP server: Git Stuff Server

Local Development

npm install
npm run build
node dist/index.js

Codex Plugin Usage

This repo can also be installed as a Codex plugin because it contains:

  • .codex-plugin/plugin.json

  • .mcp.json

  • a bundled dist/index.js

Build before committing/publishing:

npm install
npm run build

Then push the repo to GitHub. Users can install the plugin from the GitHub repo in Codex.

Client Integrations

This repo includes ready-to-copy MCP config snippets for:

  • OpenAI Codex

  • Codex plugin wrapper

  • Cursor

  • Claude Desktop

  • Claude Code

  • Windsurf / Cascade

  • Cline

  • VS Code / GitHub Copilot Agent Mode

See docs/CLIENTS.md.

Direct MCP Client Config

After publishing to npm:

{
  "mcpServers": {
    "rn-upgrade-helper": {
      "command": "npx",
      "args": ["-y", "rn-upgrade-helper-mcp"]
    }
  }
}

For local testing from this repo:

{
  "mcpServers": {
    "rn-upgrade-helper": {
      "command": "node",
      "args": ["/absolute/path/to/rn-upgrade-helper-mcp/dist/index.js"]
    }
  }
}

Example Inputs

Example upgrade request:

{
  "from": "0.73.9",
  "to": "0.79.2",
  "appName": "MyApp",
  "packageName": "com.example.myapp"
}

Publishing

npm install
npm run build
npm publish --access public

If publishing under an internal scope, rename the package first:

{
  "name": "@your-scope/rn-upgrade-helper-mcp"
}

Then update the MCP client config to use the scoped package name.

Notes

  • The server requires Node 18.18+ because it uses native fetch.

  • Diffs are fetched from:

    • https://raw.githubusercontent.com/react-native-community/rn-diff-purge/diffs/diffs/<from>..<to>.diff

    • fallback: https://github.com/react-native-community/rn-diff-purge/compare/release/<from>..release/<to>.diff

  • Package name and app name are applied by replacing com.rndiffapp, com/rndiffapp, and RnDiffApp in the generated template diff.

Available Tools

5 tools
get_file_diffB

Return the Upgrade Helper diff for one changed file.

Inputs: to (required), from (required), filePath (required), appName, +2 more.

get_upgrade_diffC

Return the full Upgrade Helper diff, optionally filtered by platform.

Inputs: to (required), from (required), appName, maxChars, +2 more.

get_upgrade_helper_urlB

Build the React Native Upgrade Helper URL for a version upgrade.

Inputs: to (required), from (required), appName, packageName.

list_changed_filesB

List files changed by React Native Upgrade Helper / rn-diff-purge for a version upgrade.

Inputs: to (required), from (required), appName, platform, +1 more.

summarize_upgradeB

Summarize the changed areas for a React Native version upgrade.

Inputs: to (required), from (required), appName, packageName.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation4/5

    Tools are mostly distinct: URL generation, file listing, per-file diff, full diff, and summary each target different outputs. Minor overlap exists between list_changed_files and get_upgrade_diff (both relate to changes), but descriptions clarify that one returns filenames and the other returns diff content.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case (get_, list_, summarize_). The verbs are varied but all are imperative and descriptive, making the naming predictable and easy to scan.

    Tool Count5/5

    With 5 tools, the set is tightly scoped to the domain of React Native upgrade assistance. Each tool serves a distinct purpose without redundancy, and the count is appropriate for the seemingly narrow but useful functionality.

    Completeness5/5

    The toolset covers the core workflow: generate a URL, list affected files, inspect individual diffs, obtain the full diff, and get a summary. There are no obvious gaps that would prevent an agent from completing an upgrade assessment.

    Related MCP Connectors

    Related MCP Servers