This MCP server automates React Native CLI project upgrades by providing version management and generating comprehensive migration diffs.
Fetch Latest Stable Version: Retrieve the most recent production-ready React Native release from GitHub, excluding betas and release candidates
Access Release Candidates: Get pre-release RC versions for early testing and feature validation
Generate Upgrade/Downgrade Diffs: Create detailed differences between any two React Native versions using
rn-diff-purge, showing:Package.json dependencies and versions
iOS configuration (Podfile, xcodeproj settings)
Android configuration (build.gradle, settings.gradle)
Project structure changes
Binary file updates
Template file modifications
Native code changes
Automatic Version Detection: Auto-detect the current React Native version from your project's
package.jsonif not explicitly providedMigration Guidance: Receive step-by-step instructions for applying upgrades, including dependency updates, configuration changes, binary file handling, and build tool version updates
Troubleshooting Support: Get package-manager-specific troubleshooting steps including Pod cleanup, Gradle wrapper updates, and dependency reinstallation
Preserve Custom Code: Apply upgrades while maintaining existing customizations in native code, configuration files, and TypeScript/JavaScript files
Supports React Native Android configuration analysis and upgrade assistance, helping manage Android-specific native code changes during React Native upgrades.
Streamlines Expo React Native app upgrades and configurations, helping developers manage Expo SDK upgrades and configuration changes.
Offers integration capabilities with GitHub Copilot, enhancing the development experience by providing AI-assisted React Native guidance.
Provides tools for handling iOS configurations in React Native projects, assisting with iOS-specific native code changes during React Native upgrades.
Provides platform-specific tools for React Native development on macOS, helping with configuration and upgrade processes.
Enables streamlined React Native development workflows including project initialization, configuration, and AI-assisted development guidance.
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: Hi-AI
🔧 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