rn-upgrade-helper-mcp
Provides tools to fetch and apply upgrade diffs for React Native projects, helping with version migrations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rn-upgrade-helper-mcp Get upgrade diff from 0.73.9 to 0.79.2"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 byandroid,ios, orjs.summarize_upgrade: summarizes changed areas and notable files.
Related MCP server: Git Stuff Server
Local Development
npm install
npm run build
node dist/index.jsCodex Plugin Usage
This repo can also be installed as a Codex plugin because it contains:
.codex-plugin/plugin.json.mcp.jsona bundled
dist/index.js
Build before committing/publishing:
npm install
npm run buildThen 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 publicIf 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>.difffallback:
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, andRnDiffAppin the generated template diff.
Available Tools
5 toolsget_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
Scored across 5 tools
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.
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.
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.
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
Cloudflare Workers MCP server: diff-patch-tools
Related MCP Servers
- AlicenseBqualityDmaintenanceThis MCP server provides unified diffs of two text inputs using Python's standard library difflib.19MIT
- AlicenseCqualityDmaintenanceMCP server providing Git-related functionalities, primarily a tool to generate diffs for Git merge commits against their first parent.4MIT
- AlicenseBqualityDmaintenanceAutomates the React Native Upgrade Helper website to extract upgrade information and file diffs between React Native versions.23MIT
- AlicenseNot gradedqualityAmaintenanceA plugin-based MCP server for React Native runtime debugging, inspection, and automation via Chrome DevTools Protocol. Works with Expo, bare React Native, and any Metro + Hermes project without app code changes.1,412 npm89MIT