RN-upgrade-helper-MCP

# React Native Upgrade Helper MCP Server A Model Context Protocol (MCP) server that automates the [React Native Upgrade Helper](https://react-native-community.github.io/upgrade-helper/) website to extract upgrade information between React Native versions. ## What It Does This MCP server uses Playwright to automatically: 1. Fill out the React Native Upgrade Helper form with your version details 2. Extract comprehensive upgrade information including file diffs 3. Return structured JSON data that AI assistants can use to help with React Native upgrades ## Installation 1. **Clone and install dependencies:** ```bash git clone <repository-url> cd react-native-upgrade-helper-mcp npm install ``` 2. **Install Playwright browser:** ```bash npx playwright install chromium ``` 3. **Build the project:** ```bash npm run build ``` ## Configuration Add this server to your MCP client configuration: ### Claude Code Add to `~/.config/claude-code/mcp_servers.json`: ```json { "mcpServers": { "react-native-upgrade-helper": { "command": "node", "args": ["/absolute/path/to/react-native-upgrade-helper-mcp/dist/index.js"] } } } ``` ### Claude Desktop Add to `claude_desktop_config.json`: ```json { "mcpServers": { "react-native-upgrade-helper": { "command": "node", "args": ["/absolute/path/to/react-native-upgrade-helper-mcp/dist/index.js"] } } } ``` ### Cursor Add to your MCP settings: ```json { "servers": { "react-native-upgrade-helper": { "command": "node", "args": ["/absolute/path/to/react-native-upgrade-helper-mcp/dist/index.js"] } } } ``` **Important:** Replace `/absolute/path/to/react-native-upgrade-helper-mcp/` with the actual absolute path to this project directory. ## Usage The server provides two tools: ### 1. `get_upgrade_info` Get comprehensive upgrade information between React Native versions. **Parameters:** - `fromVersion` (required): Source React Native version (e.g., "0.70.14") - `toVersion` (required): Target React Native version (e.g., "0.74.0") - `packageName` (optional): Package name (default: "com.example.app") - `projectName` (optional): Project name (default: "ExampleApp") **Example:** ``` @react-native-upgrade-helper get_upgrade_info fromVersion=0.70.14 toVersion=0.74.0 ``` ### 2. `get_file_diff` Get specific file differences for the upgrade. **Parameters:** - `fromVersion` (required): Source React Native version - `toVersion` (required): Target React Native version - `fileName` (required): Specific file to get diff for (e.g., "package.json") - `packageName` (optional): Package name (default: "com.example.app") - `projectName` (optional): Project name (default: "ExampleApp") **Example:** ``` @react-native-upgrade-helper get_file_diff fromVersion=0.70.14 toVersion=0.74.0 fileName=package.json ``` ## Example AI Prompts Once configured, you can ask your AI assistant: - "Help me upgrade my React Native app from 0.70.14 to 0.74.0. What changes do I need to make?" - "Show me the specific changes needed for package.json when upgrading to RN 0.74.0" - "What are the breaking changes when upgrading from React Native 0.70 to 0.74?" ## Output Format ### `get_upgrade_info` returns: ```json { "fromVersion": "0.70.14", "toVersion": "0.74.0", "packageName": "com.example.app", "projectName": "ExampleApp", "url": "https://react-native-community.github.io/upgrade-helper/", "summary": "Upgrade summary information", "breakingChanges": ["Breaking change descriptions"], "fileChanges": [ { "fileName": "package.json", "changeType": "modified", "hasChanges": true, "content": "diff content..." } ], "totalFiles": 15, "modifiedFiles": 12, "addedFiles": 2, "deletedFiles": 1 } ``` ### `get_file_diff` returns: ```json { "fromVersion": "0.70.14", "toVersion": "0.74.0", "fileName": "package.json", "changeType": "modified", "diff": "actual diff content...", "found": true } ``` ## Development ```bash # Run in development mode npm run dev # Build for production npm run build # Test the server manually echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | node dist/index.js ``` ## Troubleshooting **Playwright issues:** Ensure Chromium is installed: ```bash npx playwright install chromium ``` **Permission errors:** Make sure the script is executable: ```bash chmod +x dist/index.js ``` **Path issues:** Always use absolute paths in MCP configuration files. **Network timeouts:** The server waits 15 seconds for page loads. For slower connections, modify the timeout in `src/index.ts`. ## License MIT License