This MCP server automates React Native project upgrades by analyzing version differences and providing detailed migration guidance.
Key Capabilities:
Version Discovery & Validation: Fetch the latest stable React Native version, retrieve available Release Candidate (RC) versions for pre-release evaluation, and validate user-specified semantic version numbers
Upgrade Diff Generation: Create comprehensive diffs between any two React Native versions (current to target, including upgrades and downgrades) showing:
Package.json dependency changes
iOS configurations (Podfile, Xcode settings)
Android configurations (build.gradle, settings.gradle)
Project structure modifications
Native code and binary file updates
Template file changes
Migration Guidance: Provide step-by-step instructions for applying changes while:
Preserving custom configurations and user code
Updating only necessary dependencies
Handling build tooling updates
Offering troubleshooting steps tailored to your package manager (pod install, Gradle wrapper updates, dependency reinstallation)
Smart Version Management: Automatically detects the current version from package.json and ensures proper semantic versioning throughout the upgrade process
Provides automated tools for upgrading React Native CLI projects between versions, generating detailed upgrade/downgrade diffs and step-by-step migration guidance using rn-diff-purge
react-native-upgrader-mcp
A Model Context Protocol (MCP) server that streamlines React Native project upgrades. It provides developers with automated tools to seamlessly upgrade React Native CLI projects to any desired version or the latest stable release. The MCP Server uses rn-diff-purge to generate the diff.
🚀 Features
Version Management: Fetch and track the latest stable React Native versions with semantic versioning support
Upgrade Automation: Generate detailed upgrade/downgrade diffs between versions with step-by-step migration guidance
Release Candidate Support: Access and evaluate pre-release versions for early testing and feature validation
Important: This MCP Server is not compatible with Expo projects.
Related MCP server: Figma to React Native MCP
🔧 Setup
Cursor
Open Cursor Settings
Look for an option called "Tools and integrations" and click on it
Click on "New MCP Server"
Configure:
{ "mcpServers": { "react-native-upgrader-mcp": { "command": "npx", "args": ["-y", "react-native-upgrader-mcp"] } } }Restart Cursor
VS Code
Install MCP extension (e.g., "MCP Server Manager")
Configure:
{ "mcp.servers": { "react-native-upgrader-mcp": { "command": "npx", "args": ["-y", "react-native-upgrader-mcp"] } } }
🛠️ Tools
get-stable-version- Get latest stable versionget-react-native-diff- Generate upgrade diff between versionsget-rc-version- Get RC versions
🛠️ Development
🤝 Contributing
Fork the repository
Create a feature branch
Make your changes
Submit a pull request