RN-upgrade-helper

This MCP server automates the React Native Upgrade Helper web experience by driving Playwright to fill out version forms and extract upgrade data. It exposes two main tools: get_upgrade_info and get_file_diff. get_upgrade_info returns a comprehensive overview of the upgrade between two RN versions, including a summary, breaking changes, and a list of file changes. get_file_diff focuses on a specific file (e.g., package.json) and returns the exact diff between the two versions. To use, ensure the MCP server is running and invoke the tools with the required parameters (versions, and optional packageName and projectName). The server returns structured JSON that AI assistants can leverage to guide developers through upgrading RN projects.

Prerequisites:

• Node.js and npm installed on your machine
• Access to clone the MCP server repository

Installation steps:

1. Clone the repository and install dependencies

git clone <repository-url>
cd react-native-upgrade-helper-mcp
npm install

2. Install Playwright browser (Chromium)

npx playwright install chromium

3. Build the project

npm run build

4. Start the MCP server (example)

node dist/index.js

Note: Adjust environment as needed (see configuration notes) and ensure absolute paths used in MCP client configurations.

Tips and common issues:

• Ensure Chromium/Playwright is installed correctly with npx playwright install chromium.
• If you encounter permission errors, verify that dist/index.js is executable (chmod +x dist/index.js).
• Always use absolute paths in MCP client configuration files when pointing to the server entry point.
• If network timeouts occur, you can adjust the page load timeout in the server source (src/index.ts) to accommodate slower connections.
• This MCP server relies on Playwright to render the React Native Upgrade Helper page; ensure the environment supports headless browser automation (CI or local).
• The server exposes two tools: get_upgrade_info and get_file_diff; provide required parameters like fromVersion and toVersion, and optionally packageName and projectName.