{"_id":"@divagnz/mcp-react-native-expo","name":"@divagnz/mcp-react-native-expo","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@divagnz/mcp-react-native-expo","version":"0.0.1","description":"React Native Expo MCP server - forked and expanded with expert code remediation, advanced refactoring, modular architecture, and comprehensive testing. Professional development companion for React Native teams with upcoming Expo, ADB, and iOS tool integra","type":"module","main":"build/index.js","bin":{"mcp-react-native-expo":"build/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node build/index.js","test":"jest","test:watch":"jest --watch","test:coverage":"jest --coverage","test:badges":"npm run test:coverage && jest-coverage-badges","test:ci":"jest --coverage --ci --maxWorkers=2","lint":"eslint src/**/*.ts","lint:fix":"eslint src/**/*.ts --fix","format":"prettier --write src/**/*.ts","format:check":"prettier --check src/**/*.ts","type-check":"tsc --noEmit","quality":"npm run lint && npm run format:check && npm run type-check","prepublishOnly":"npm run quality && npm test && npm run build","prepare":"husky"},"keywords":["mcp","model-context-protocol","react-native","code-analysis","performance-optimization","best-practices","debugging","package-management","dependency-resolution","security-audit","ai-assistant","developer-tools","code-quality","testing","accessibility","linting","refactoring"],"author":{"name":"Divagnz","url":"https://github.com/Divagnz"},"contributors":[{"name":"mrnitro360"}],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Divagnz/mcp-react-native-expo.git"},"bugs":{"url":"https://github.com/Divagnz/mcp-react-native-expo/issues"},"homepage":"https://github.com/Divagnz/mcp-react-native-expo#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","qrcode":"^1.5.4","winston":"^3.18.3","zod":"^3.23.8"},"devDependencies":{"@jest/globals":"^29.7.0","@types/jest":"^29.5.14","@types/node":"^20.0.0","@types/qrcode":"^1.5.6","@typescript-eslint/eslint-plugin":"^8.46.2","@typescript-eslint/parser":"^8.46.2","eslint":"^9.39.0","eslint-config-prettier":"^10.1.8","eslint-plugin-jest":"^29.0.1","globals":"^16.5.0","husky":"^9.1.7","jest":"^29.7.0","jest-coverage-badges":"^1.1.2","lint-staged":"^16.2.6","prettier":"^3.6.2","ts-jest":"^29.4.5","tsx":"^4.0.0","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"overrides":{"minimist":"^1.2.8"},"lint-staged":{"*.ts":["prettier --write"],"src/index.ts":["eslint --fix"],"src/{prompts,resources}/**/*.ts":["eslint --fix"]},"_id":"@divagnz/mcp-react-native-expo@0.0.1","gitHead":"b0858e0657fda01968502f0738ba78824a0a47db","types":"./build/index.d.ts","_nodeVersion":"20.19.5","_npmVersion":"10.8.2","dist":{"integrity":"sha512-SQGrEZQc6NJ2+DBHEmuhwYtuaiXEeoXmyHGgl6hZNO8kL8xwc8CKFQR0c3fgj5PlbO/bxMLvhp28XRQktOMxlQ==","shasum":"d7cb3b106a1e73149100bcb735477ac476dc1433","tarball":"https://registry.npmjs.org/@divagnz/mcp-react-native-expo/-/mcp-react-native-expo-0.0.1.tgz","fileCount":199,"unpackedSize":776783,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@divagnz%2fmcp-react-native-expo@0.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDxwQs5HXfpJ9RLZA9nARxGo3koqtjP4nzsF4cA0prAVAiAED0H89UanFNtGiQ2XU6Yu3floeEC8kmQIwPIVGhpsvw=="}]},"_npmUser":{"name":"divagnz","email":"oscar.liguori.bagnis@gmail.com"},"directories":{},"maintainers":[{"name":"divagnz","email":"oscar.liguori.bagnis@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-react-native-expo_0.0.1_1763308041331_0.21353933208891385"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-16T15:47:21.272Z","0.0.1":"2025-11-16T15:47:21.605Z","modified":"2025-11-16T15:47:22.269Z"},"maintainers":[{"name":"divagnz","email":"oscar.liguori.bagnis@gmail.com"}],"description":"React Native Expo MCP server - forked and expanded with expert code remediation, advanced refactoring, modular architecture, and comprehensive testing. Professional development companion for React Native teams with upcoming Expo, ADB, and iOS tool integra","homepage":"https://github.com/Divagnz/mcp-react-native-expo#readme","keywords":["mcp","model-context-protocol","react-native","code-analysis","performance-optimization","best-practices","debugging","package-management","dependency-resolution","security-audit","ai-assistant","developer-tools","code-quality","testing","accessibility","linting","refactoring"],"repository":{"type":"git","url":"git+https://github.com/Divagnz/mcp-react-native-expo.git"},"contributors":[{"name":"mrnitro360"}],"author":{"name":"Divagnz","url":"https://github.com/Divagnz"},"bugs":{"url":"https://github.com/Divagnz/mcp-react-native-expo/issues"},"license":"MIT","readme":"# React Native Expo MCP\n\n\n\n[](https://badge.fury.io/js/%40divagnz%2Fmcp-react-native-expo)\n[](https://opensource.org/licenses/MIT)\n[](https://modelcontextprotocol.io/)\n[](https://github.com/Divagnz/mcp-react-native-expo/actions/workflows/pr-checks.yml)\n[](https://www.typescriptlang.org/)\n[](https://reactnative.dev/)\n\n\n\n[]\n[]\n[]\n[]\n\n\n**React Native Expo MCP Server - Professional AI-powered development companion**\n\n*Expert remediation β’ Advanced refactoring β’ Enterprise architecture β’ Comprehensive testing*\n\n> **π Fork Notice:** This project is forked and significantly expanded from [@mrnitro360/react-native-mcp-guide](https://github.com/MrNitro360/React-Native-MCP), adding expert code remediation, advanced component refactoring, modular architecture with dependency injection, comprehensive testing suite (478 tests), and enterprise-grade error handling.\n\n
\n\n## Overview\n\nAn enhanced Model Context Protocol (MCP) server designed for professional React Native development teams. Built on enterprise-grade architecture with **expert-level automated code remediation**, **advanced refactoring capabilities**, comprehensive testing, and production-ready fixes.\n\n**π v0.1.0 - Test Coverage Expansion & Expo CLI Integration:**\n\n- π§ͺ **Enhanced Test Coverage** - 933 tests (78.95% lines, 90.22% branches, 81.43% functions, 78.91% statements)\n- β
**Zero Coverage Elimination** - All 18 files with 0% coverage now have comprehensive test suites\n- π¦ **Expo CLI Integration** - 15 new tools for dev servers, builds, updates, and project management\n- ποΈ **Modular Architecture** - Clean, maintainable service-based design with dependency injection\n- β‘ **Advanced Caching** - LRU cache with intelligent eviction and performance optimization\n- π **Error Handling** - Structured logging with circuit breaker and retry mechanisms\n- π§ **Expert Code Remediation** - Automatically fix security, performance, and quality issues\n- ποΈ **Advanced Refactoring** - Comprehensive component modernization and optimization\n\n**Key Benefits:**\n\n- π **Accelerated Development** - Automated code analysis, fixing, and test generation\n- π **Enterprise Security** - Vulnerability detection with automatic remediation\n- π **Quality Assurance** - Industry-standard testing frameworks and coverage analysis\n- β‘ **Performance Optimization** - Advanced profiling with automatic fixes\n- π― **Best Practices** - Expert guidance with code implementation\n- π **Automated Updates** - Continuous integration with automatic version management\n\n---\n\n## Quick Start\n\n### Prerequisites\n\n- **Node.js** 18.0 or higher\n- **Claude CLI** or **Claude Desktop**\n- **React Native** development environment\n\n### Environment Setup\n\nFor full Expo CLI functionality, configure these environment variables:\n\n#### Required for Android Development\n\n```bash\n# Android SDK location\nexport ANDROID_HOME=$HOME/Android/Sdk\nexport ANDROID_SDK_ROOT=$HOME/Android/Sdk\n\n# Add Android tools to PATH\nexport PATH=$PATH:$ANDROID_HOME/emulator\nexport PATH=$PATH:$ANDROID_HOME/platform-tools\n```\n\n#### Java Version Management (Recommended)\n\n**Use jenv for managing Java versions:**\n\n```bash\n# Install jenv (macOS)\nbrew install jenv\n\n# Add to shell profile (~/.zshrc or ~/.bashrc)\nexport PATH=\"$HOME/.jenv/bin:$PATH\"\neval \"$(jenv init -)\"\n\n# Add Java versions\njenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home\n\n# Set global version (Java 17+ recommended for React Native)\njenv global 17\n\n# Verify\njava -version # Should show 17.x.x or higher\n```\n\n**Minimum Java Version:** Java 17 (LTS)\n**Recommended:** Java 17 or 21 (LTS versions)\n\n> **Why Java 17?** Required for Android Gradle Plugin 8.0+ and modern React Native projects. Older versions may cause build failures.\n\n#### Optional: EAS CLI Authentication\n\n```bash\n# For EAS cloud builds and updates\nexport EXPO_TOKEN=your_expo_token_here\nexport EAS_TOKEN=your_eas_token_here\n```\n\n### Installation\n\n#### Automated Installation (Recommended)\n\n```bash\n# Install globally via npm\nnpm install -g @divagnz/mcp-react-native-expo\n\n# Configure with Claude CLI\nclaude mcp add mcp-react-native-expo npx @divagnz/mcp-react-native-expo\n```\n\n#### Development Installation\n\n```bash\n# Clone repository\ngit clone https://github.com/Divagnz/mcp-react-native-expo.git\ncd React-Native-MCP\n\n# Install dependencies and build\nnpm install && npm run build\n\n# Add to Claude CLI\nclaude mcp add mcp-react-native-expo node ./build/index.js\n```\n\n### Verification\n\n```bash\nclaude mcp list\n```\n\nVerify that `mcp-react-native-expo` appears as **Connected** β
\n\n---\n\n## π Expert Remediation Examples\n\n### Before vs. After: Automatic Code Fixing\n\n**β Before (Problematic Code):**\n```typescript\nconst MyComponent = () => {\n const apiKey = \"sk-1234567890abcdef\"; // Hardcoded secret\n const [data, setData] = useState([]);\n \n useEffect(() => {\n console.log(\"API Key:\", apiKey); // Sensitive logging\n fetch('http://api.example.com/data') // HTTP instead of HTTPS\n .then(response => response.json())\n .then(data => setData(data));\n \n const interval = setInterval(() => { // Memory leak\n console.log('Polling...');\n }, 1000);\n }, []);\n\n return (\n \n {data.map(item => ( // Performance issue\n {item.name}\n ))}\n \n );\n};\n```\n\n**β
After (Expert Remediation):**\n```typescript\ninterface Props {\n children?: React.ReactNode;\n onPress?: () => void;\n}\n\nconst MyComponent: React.FC = () => {\n // TODO: Add API_KEY to your environment variables\n const apiKey = process.env.API_KEY || Config.API_KEY;\n const [data, setData] = useState([]);\n \n useEffect(() => {\n // Removed sensitive logging for security\n // console.log('[REDACTED - contains sensitive data]');\n \n // Upgraded to HTTPS for security\n fetch('https://api.example.com/data')\n .then(response => response.json())\n .then(data => setData(data));\n \n const interval = setInterval(() => {\n console.log('Polling...');\n }, 1000);\n \n // Cleanup intervals to prevent memory leaks\n return () => {\n clearInterval(interval);\n };\n }, []);\n\n return (\n item.id?.toString() || index.toString()}\n renderItem={({ item }) => (\n {item.name}\n )}\n />\n );\n};\n\nconst styles = StyleSheet.create({\n itemText: {\n color: 'red'\n }\n});\n\nexport default React.memo(MyComponent);\n```\n\n**π― What Got Fixed Automatically:**\n- β
**Security**: Hardcoded API key β Environment variable\n- β
**Security**: Sensitive logging β Sanitized\n- β
**Security**: HTTP β HTTPS upgrade\n- β
**Performance**: ScrollView + map β FlatList with keyExtractor\n- β
**Memory**: Added interval cleanup to prevent leaks\n- β
**Best Practices**: Inline styles β StyleSheet.create\n- β
**Type Safety**: Added TypeScript interface\n- β
**Performance**: Wrapped with React.memo\n\n---\n\n## Core Features\n\n### π§ Expert Code Remediation\n\n| Tool | Capability | Level | Output |\n|------|------------|-------|--------|\n| **`remediate_code`** | Automatic security, performance, and quality fixes | Expert | Production-ready code |\n| **`refactor_component`** | Advanced component modernization and optimization | Senior | Refactored components with tests |\n| **Security Remediation** | Hardcoded secrets β environment variables | Enterprise | Secure code patterns |\n| **Performance Fixes** | Memory leaks, FlatList optimization, StyleSheet | Expert | Optimized components |\n| **Type Safety** | Automatic TypeScript interface generation | Professional | Type-safe code |\n\n### π§ͺ Advanced Testing Suite\n\n| Feature | Description | Frameworks |\n|---------|-------------|------------|\n| **Automated Test Generation** | Industry-standard test suites for components | Jest, Testing Library |\n| **Coverage Analysis** | Detailed reports with improvement strategies | Jest Coverage, LCOV |\n| **Strategy Evaluation** | Testing approach analysis and recommendations | Unit, Integration, E2E |\n| **Framework Integration** | Multi-platform testing support | Detox, Maestro, jest-axe |\n\n### π Comprehensive Analysis Tools\n\n| Analysis Type | Capabilities | Output |\n|---------------|--------------|--------|\n| **Security Auditing** | Vulnerability detection with auto-remediation | Risk-prioritized reports + fixes |\n| **Performance Profiling** | Memory, rendering, bundle optimization + fixes | Actionable recommendations + code |\n| **Code Quality** | Complexity analysis with refactoring implementation | Maintainability metrics + fixes |\n| **Accessibility** | WCAG compliance with automatic improvements | Compliance reports + code |\n\n### π¦ Dependency Management\n\n- **Automated Package Auditing** - Security vulnerabilities and outdated dependencies\n- **Intelligent Upgrades** - React Native compatibility validation\n- **Conflict Resolution** - Dependency tree optimization\n- **Migration Assistance** - Deprecated package modernization\n\n### π Expert Knowledge Base\n\n- **React Native Documentation** - Complete API references and guides\n- **Architecture Patterns** - Scalable application design principles \n- **Platform Guidelines** - iOS and Android specific best practices\n- **Security Standards** - Mobile application security frameworks\n\n---\n\n## Usage Examples\n\n### π§ Expert Code Remediation (NEW)\n\n```bash\n# Automatically fix all detected issues with expert-level solutions\nclaude \"remediate_code with remediation_level='expert' and add_comments=true\"\n\n# Advanced component refactoring with performance optimization\nclaude \"refactor_component with refactor_type='comprehensive' and include_tests=true\"\n\n# Security-focused remediation\nclaude \"remediate_code with issues=['hardcoded_secrets', 'sensitive_logging'] and remediation_level='expert'\"\n\n# Performance-focused refactoring\nclaude \"refactor_component with refactor_type='performance' and target_rn_version='latest'\"\n```\n\n### Testing & Quality Assurance\n\n```bash\n# Generate comprehensive component tests\nclaude \"generate_component_test with component_name='LoginForm' and test_type='comprehensive'\"\n\n# Analyze testing strategy\nclaude \"analyze_testing_strategy with focus_areas=['unit', 'accessibility', 'performance']\"\n\n# Generate coverage report\nclaude \"analyze_test_coverage with coverage_threshold=85\"\n```\n\n### Code Analysis & Optimization\n\n```bash\n# Comprehensive codebase analysis with auto-remediation suggestions\nclaude \"analyze_codebase_comprehensive\"\n\n# Performance optimization with specific focus areas\nclaude \"analyze_codebase_performance with focus_areas=['memory_usage', 'list_rendering']\"\n\n# Security audit with vulnerability detection\nclaude \"analyze_codebase_comprehensive with analysis_types=['security', 'performance']\"\n```\n\n### Dependency Management\n\n```bash\n# Package upgrade recommendations\nclaude \"upgrade_packages with update_level='minor'\"\n\n# Resolve dependency conflicts\nclaude \"resolve_dependencies with fix_conflicts=true\"\n\n# Security vulnerability audit\nclaude \"audit_packages with auto_fix=true\"\n```\n\n### Real-World Scenarios\n\n| Scenario | Command | Outcome |\n|----------|---------|---------|\n| **π§ Automatic Code Fixing** | `\"Fix all security and performance issues in my component with expert solutions\"` | Production-ready remediated code |\n| **ποΈ Component Modernization** | `\"Refactor my legacy component to modern React Native patterns with tests\"` | Modernized component + test suite |\n| **π‘οΈ Security Hardening** | `\"Automatically fix hardcoded secrets and security vulnerabilities\"` | Secure code with environment variables |\n| **β‘ Performance Optimization** | `\"Fix memory leaks and optimize FlatList performance automatically\"` | Optimized code with cleanup |\n| **π Type Safety Enhancement** | `\"Add TypeScript interfaces and improve type safety automatically\"` | Type-safe code with interfaces |\n| **Pre-deployment Security Check** | `\"Scan my React Native project for security vulnerabilities\"` | Security report + automatic fixes |\n| **Performance Bottleneck Analysis** | `\"Analyze my app for performance bottlenecks and memory leaks\"` | Optimization roadmap + fixes |\n| **Code Quality Review** | `\"Review my codebase for refactoring opportunities\"` | Quality improvement + implementation |\n| **Accessibility Compliance** | `\"Check my app for accessibility issues and fix them automatically\"` | WCAG compliance + code fixes |\n| **Component Test Generation** | `\"Generate comprehensive tests for my LoginScreen component\"` | Complete test suite |\n| **Testing Strategy Optimization** | `\"Analyze my current testing strategy and suggest improvements\"` | Testing roadmap |\n\n---\n\n## Claude Desktop Integration\n\n### NPM Installation Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"mcp-react-native-expo\": {\n \"command\": \"npx\",\n \"args\": [\"@divagnz/mcp-react-native-expo@0.0.1\"],\n \"env\": {}\n }\n }\n}\n```\n\n### Development Configuration\n\n```json\n{\n \"mcpServers\": {\n \"mcp-react-native-expo\": {\n \"command\": \"node\",\n \"args\": [\"/absolute/path/to/React-Native-MCP/build/index.js\"],\n \"env\": {}\n }\n }\n}\n```\n\n**Configuration Paths:**\n- **Windows:** `C:\\Users\\{Username}\\Desktop\\React-Native-MCP\\build\\index.js`\n- **macOS/Linux:** `/Users/{Username}/Desktop/React-Native-MCP/build/index.js`\n\n---\n\n## Development & Maintenance\n\n### Local Development\n\n```bash\n# Development with hot reload\nnpm run dev\n\n# Production build\nnpm run build\n\n# Production server\nnpm start\n```\n\n### Continuous Integration\n\nThis project implements enterprise-grade CI/CD:\n\n- β
**Automated Version Management** - Semantic versioning with auto-increment\n- β
**Continuous Deployment** - Automatic npm publishing on merge\n- β
**Release Automation** - GitHub releases with comprehensive changelogs\n- β
**Quality Gates** - Build validation and testing before deployment\n\n### Update Management\n\n```bash\n# Check current version\nnpm list -g @divagnz/mcp-react-native-expo\n\n# Update to latest version\nnpm update -g @divagnz/mcp-react-native-expo\n\n# Reconfigure Claude CLI\nclaude mcp remove mcp-react-native-expo\nclaude mcp add mcp-react-native-expo npx @divagnz/mcp-react-native-expo\n```\n\n---\n\n## Technical Specifications\n\n### π― Analysis & Remediation Capabilities\n\n- **Expert Code Remediation** - Automatic fixing of security, performance, and quality issues\n- **Advanced Component Refactoring** - Comprehensive modernization with test generation\n- **Comprehensive Codebase Analysis** - Multi-dimensional quality assessment with fixes\n- **Enterprise Security Auditing** - Vulnerability detection with automatic remediation\n- **Performance Intelligence** - Memory, rendering, and bundle optimization with fixes\n- **Quality Metrics** - Complexity analysis with refactoring implementation\n- **Accessibility Compliance** - WCAG 2.1 AA standard validation with automatic fixes\n- **Testing Strategy Optimization** - Coverage analysis and framework recommendations\n\n### π οΈ Technical Architecture\n\n- **33 Specialized Tools** - Complete React Native development lifecycle coverage + remediation\n - 17 core analysis and remediation tools\n - 15 Expo CLI integration tools\n - 1 help/documentation tool\n- **2 Expert Remediation Tools** - `remediate_code` and `refactor_component`\n- **6 Expert Prompt Templates** - Structured development workflows\n- **5 Resource Libraries** - Comprehensive documentation and best practices\n- **Industry-Standard Test Generation** - Automated test suite creation\n- **Multi-Framework Integration** - Jest, Detox, Maestro, and accessibility tools\n- **Real-time Coverage Analysis** - Detailed reporting with improvement strategies\n- **Production-Ready Code Generation** - Expert-level automated fixes and refactoring\n\n### π’ Enterprise Features\n\n- **Expert-Level Remediation** - Senior engineer quality automatic code fixes\n- **Production-Ready Solutions** - Enterprise-grade security and performance fixes\n- **Professional Reporting** - Executive-level summaries with implementation code\n- **Security-First Architecture** - Comprehensive vulnerability assessment with fixes\n- **Scalability Planning** - Large-scale application design patterns with refactoring\n- **Compliance Support** - Industry standards with automatic compliance fixes\n- **Multi-Platform Optimization** - iOS and Android specific considerations with fixes\n\n---\n\n## πΊοΈ Roadmap\n\n### Current Release - v0.0.1 β
\n\n**Core Infrastructure & Foundation**\n- β
Modular architecture with dependency injection\n- β
Advanced LRU caching system\n- β
Comprehensive testing suite (735+ tests, 91.38% branch coverage)\n- β
Structured logging with circuit breaker patterns\n- β
Expert code remediation capabilities\n- β
Advanced component refactoring tools\n- β
17 specialized React Native development tools\n\n**Current Tools Include:**\n- Component analysis and optimization\n- Performance profiling and optimization\n- Security auditing and remediation\n- Code quality analysis\n- Testing strategy and coverage analysis\n- Package management and upgrades\n- Debugging guidance\n- Architecture advice\n\n### Upcoming Features π\n\n#### Expo CLI Integration (v0.1.0 - Planned)\n- π Development server management (start, QR codes, logs, controls)\n- π EAS cloud build management (trigger, status, submit)\n- π Project management tools (doctor, install, upgrade)\n- π OTA update publishing with rollout control\n- π 15 comprehensive Expo CLI tools (7 session-based + 8 one-shot)\n\n#### ADB (Android Debug Bridge) Integration\n- π Device connection and management\n- π App installation and uninstallation\n- π Logcat monitoring and filtering\n- π Screenshot and screen recording\n- π Visual regression testing\n- π Performance profiling tools\n- π Complete Android development workflow\n\n#### iOS Development Tools\n- π Simulator management\n- π Device provisioning\n- π Build and deployment tools\n- π iOS-specific debugging\n- π TestFlight integration\n- π Complete iOS development workflow\n\n**Future Enhancements**\n- π Enhanced performance profiling\n- π Extended accessibility testing\n- π CI/CD pipeline templates\n- π Multi-platform workflow automation\n\n---\n\n## β οΈ Known Limitations\n\n### Current Version (v0.1.0)\n\nWhile the MCP server provides comprehensive React Native development capabilities, there are some known limitations based on real-world usage:\n\n#### Process Management\n- **Manual process cleanup required:** Port 8081 conflicts must be manually resolved using `lsof -ti:8081 | xargs kill -9`\n- **No session visibility:** Cannot easily list or monitor active Expo/Metro processes\n- **Zombie sessions:** No automatic cleanup of orphaned processes\n\n**Workarounds:**\n- Manually kill processes before starting new sessions\n- Use `ps aux | grep -E \"expo|metro\"` to find running processes\n- Tools in development: `expo_sessions_list`, `expo_kill_process`, `expo_cleanup`\n\n#### Dependency Management\n- **Manual expo-doctor required:** Users must run `npx expo-doctor` and `npx expo install --check` manually\n- **Multiple fix iterations:** Dependency conflicts (27+ packages) require multiple rounds of manual fixes\n- **Version downgrades:** Some packages (e.g., react-native-worklets 0.6.1 β 0.5.1) need manual attention\n\n**Workarounds:**\n- Run `npx expo install --check` before major builds\n- Use `expo install` instead of `yarn add` for Expo packages\n- Tools in development: `expo_doctor`, `expo_install_check`\n\n#### Environment Validation\n- **Late build failures:** Environment issues (Java version, ANDROID_HOME) not detected until builds fail\n- **Java 24 incompatibility:** No pre-flight check for Java version compatibility with Gradle\n- **No proactive warnings:** Issues discovered 10+ minutes into builds\n\n**Workarounds:**\n- Manually verify Java version: `java -version` (should be 17-21, not 24+)\n- Use jenv to manage Java versions: `jenv shell 17`\n- Check ANDROID_HOME before builds: `echo $ANDROID_HOME`\n- Tools in development: `expo_validate_environment`\n\n#### Polyfill Detection\n- **Manual polyfill setup:** Users must manually add Buffer and EventTarget polyfills for Hermes\n- **Runtime errors only:** Polyfill needs discovered only when app crashes\n- **20+ lines of manual code:** EventTarget implementation requires manual coding\n\n**Workarounds:**\n- Add polyfills to `app/_layout.tsx` before other imports\n- Test on physical devices early to catch Hermes issues\n- Tools in development: `expo_detect_polyfills`, `expo_setup_polyfills`\n\n#### Tool Reliability\n- **60% failure rate:** In some sessions, ~60% of tool calls fail (vs. target >95%)\n- **Tool naming confusion:** Incorrect prefix attempts (`mcp__react-native-guide__*` vs `mcp__mcp-react-native-expo__*`)\n- **Connection failures:** MCP server reconnections fail without diagnostics\n- **Undefined returns:** Some tools return `undefined` instead of proper error messages\n\n**Workarounds:**\n- Check tool names with `expo_help()` (when available)\n- Restart Claude Desktop if tools become unavailable\n- Use `/mcp` command to check server status\n- Improvements in progress for v0.2.0\n\n#### Log Management\n- **Token overflow:** Build logs (34K+ tokens) exceed 25K limit\n- **Verbose Gradle output:** 300+ lines of low-value logs make it hard to find errors\n- **No filtering:** Cannot view errors-only or progress-only modes\n\n**Workarounds:**\n- Use `tail` parameter to limit log output\n- Manually scan logs for \"ERROR\" or \"WARN\" keywords\n- Tools in development: Smart log filtering with `--errors-only`, `--progress` modes\n\n### Impact Summary\n\nBased on real-world usage analysis:\n- **~41 minutes of manual work** per typical workflow\n- **16+ failed tool calls** in a single session\n- **90%+ of issues preventable** with planned improvements\n\n### Improvement Timeline\n\nSee [IMPROVEMENT_ROADMAP.md](./IMPROVEMENT_ROADMAP.md) for detailed improvement plans.\n\n**All improvements consolidated into v0.1.0 release:**\n\n- β
Process management tools (sessions list, kill, cleanup)\n- β
Standardized response format across all tools\n- β
Tool reliability fixes (zero \"no such tool\" errors)\n- β
Dependency management (expo-doctor, auto-fix versions)\n- β
Environment validation (pre-build checks)\n- β
Polyfill automation (detection and setup)\n- β
Smart logging (errors-only, progress tracking)\n- β
Build diagnostics (timeout detection, Gradle analysis)\n- β
Interactive help system (expo_help, error codes)\n- β
Comprehensive documentation\n\n**Target:** >95% tool success rate, <5 minutes manual intervention per workflow\n\n---\n\n## π§ Troubleshooting\n\n### Quick Fixes for Common Issues\n\n#### Port 8081 Already in Use\n\n```bash\n# Find and kill the process\nlsof -ti:8081 | xargs kill -9\n\n# Or kill all Metro/Expo processes\npkill -f \"metro|expo\"\n```\n\n#### Java Version Error (Gradle Builds)\n\n```bash\n# Check current version\njava -version\n\n# If showing Java 24, switch to 17 or 21\njenv shell 17\n\n# Verify\njava -version # Should show 17.x.x\n```\n\n#### Buffer/EventTarget Polyfill Errors\n\nAdd to `app/_layout.tsx` (before imports):\n\n```typescript\n// Minimal Buffer polyfill\nif (typeof global.Buffer === 'undefined') {\n global.Buffer = {\n from: (data: any) => String(data),\n isBuffer: () => false,\n } as any;\n}\n\n// EventTarget polyfill\nif (typeof global.EventTarget === 'undefined') {\n global.EventTarget = class EventTarget {\n private listeners = new Map();\n addEventListener(type: string, listener: Function) {\n if (!this.listeners.has(type)) {\n this.listeners.set(type, new Set());\n }\n this.listeners.get(type)?.add(listener);\n }\n removeEventListener(type: string, listener: Function) {\n this.listeners.get(type)?.delete(listener);\n }\n dispatchEvent(event: any) {\n this.listeners.get(event.type)?.forEach(l => l(event));\n return true;\n }\n } as any;\n}\n```\n\n#### Dependency Version Conflicts\n\n```bash\n# Check for issues\nnpx expo-doctor\n\n# Auto-fix all\nnpx expo install --check --fix\n\n# Install missing peer dependencies\nyarn add @expo/metro-runtime react-native-worklets\n```\n\n#### MCP Tools Not Available\n\n```bash\n# Verify MCP configuration\ncat ~/.config/claude-desktop/mcp.json\n\n# Restart Claude Desktop\n# Or use /mcp command in Claude\n```\n\n### Getting Help\n\nFor detailed troubleshooting, see:\n- [PAIN_POINTS.md](./PAIN_POINTS.md) - Comprehensive pain points analysis with real examples\n- [EXPO_TOOLS_SPEC.md](./EXPO_TOOLS_SPEC.md#-troubleshooting-guide) - Detailed Expo tools troubleshooting\n- [GitHub Issues](https://github.com/Divagnz/mcp-react-native-expo/issues) - Report bugs and request features\n\nWhen reporting issues, include:\n- OS and version\n- Node.js version (`node --version`)\n- Expo SDK version (`npx expo --version`)\n- Java version (`java -version`)\n- Full error logs\n- Steps to reproduce\n\n---\n\n## π Changelog\n\n### v0.1.0 - Test Coverage Expansion & Expo CLI Integration (Latest)\n\n**π§ͺ Enhanced Test Coverage:**\n- **198 new tests** added across 12 files to eliminate 0% function coverage\n- **933 total tests** (up from 735)\n- **Coverage improvements:**\n - Lines: 78.95% (previously 74.1%)\n - Branches: 90.22% (stable)\n - Functions: 81.43% (up from ~75%)\n - Statements: 78.91% (up from 74.1%)\n- **All 18 files** with 0% coverage now have comprehensive test suites (25%+ coverage each)\n\n**π¦ Expo CLI Integration (15 new tools):**\n- **Dev Server Management** (4 tools): `expo_start_dev_server`, `expo_read_dev_logs`, `expo_send_dev_command`, `expo_stop_dev_server`\n- **EAS Cloud Builds** (3 tools): `expo_trigger_eas_build`, `expo_get_eas_build_status`, `expo_submit_to_store`\n- **Local Builds** (3 tools): `expo_start_local_build`, `expo_read_build_logs`, `expo_stop_local_build`\n- **Project Management** (3 tools): `expo_create_app`, `expo_run_doctor`, `expo_install_packages`, `expo_upgrade_sdk`\n- **OTA Updates** (2 tools): `expo_publish_eas_update`, `expo_get_update_status`\n\n**β
Test Coverage by Category:**\n\n1. **Expo Build Cloud** (3 files, 23 tests)\n - `build.test.ts`: EAS cloud build triggering (8 tests)\n - `status.test.ts`: Build status monitoring (8 tests)\n - `submit.test.ts`: App store submission (8 tests)\n\n2. **Expo Build Local** (3 files, 23 tests)\n - `start.test.ts`: Local build initiation (8 tests)\n - `read.test.ts`: Build log monitoring (8 tests)\n - `stop.test.ts`: Build termination (6 tests)\n\n3. **Expo Dev Server** (4 files, 31 tests)\n - `start.test.ts`: Dev server lifecycle (8 tests)\n - `read.test.ts`: Log streaming (7 tests)\n - `send.test.ts`: Dev commands (9 tests)\n - `stop.test.ts`: Server shutdown (6 tests)\n\n4. **Expo Project Tools** (4 files, 41 tests)\n - `create.test.ts`: Project scaffolding (10 tests)\n - `doctor.test.ts`: Health diagnostics (9 tests)\n - `install.test.ts`: Package installation (9 tests)\n - `upgrade.test.ts`: SDK upgrades (13 tests)\n\n5. **Expo OTA Updates** (2 files, 24 tests)\n - `publish.test.ts`: Update publishing (13 tests)\n - `status.test.ts`: Update monitoring (11 tests)\n\n6. **Component Analyzer** (1 file, 22 tests)\n - React Native code quality analysis\n - Security, performance, and memory leak detection\n - StyleSheet and caching optimization\n\n7. **Advisory Service** (1 file, 35 tests)\n - Performance optimization guidance (6 scenarios)\n - Architecture recommendations (7 patterns)\n - Debugging assistance (5 issue types with platform specifics)\n\n**π§ Quality Improvements:**\n- All new tests use consistent mocking patterns\n- Comprehensive edge case coverage (error handling, missing data, timeouts)\n- Platform-specific test coverage (iOS, Android, both)\n- Output parsing validation for all Expo CLI commands\n\n**π Workflow Validation:**\n- β
All tests pass in CI/CD pipeline\n- β
Linting and type checking passing\n- β
Coverage badges auto-generated\n- β
No skipped/pending tests allowed in PR checks\n\n### v0.0.1 - Initial Release\n\n**π First Release with Enterprise-Grade Features:**\n- ποΈ **Modular Architecture** - Service-based design with dependency injection\n- β‘ **Advanced Caching** - LRU cache system with intelligent eviction\n- π§ͺ **Comprehensive Testing** - 735 tests with 91.38% branch coverage\n- π **Error Handling** - Structured logging with circuit breaker patterns\n- π§ **Expert Code Remediation** - Automatic security, performance, and quality fixes\n- ποΈ **Advanced Refactoring** - Component modernization with test generation\n\n**π― Core Capabilities:**\n- 17 specialized tools for React Native development\n- Expert code remediation and refactoring\n- Security auditing with automatic fixes\n- Performance optimization and profiling\n- Comprehensive codebase analysis\n- Testing strategy and coverage analysis\n- Package management and dependency resolution\n- Accessibility compliance checking\n\n---\n\n## Support & Community\n\n### Resources\n\n- π¦ **[NPM Package](https://www.npmjs.com/package/@divagnz/mcp-react-native-expo)** - Official package repository\n- π **[GitHub Repository](https://github.com/Divagnz/mcp-react-native-expo)** - Source code and development\n- π **[Issue Tracker](https://github.com/Divagnz/mcp-react-native-expo/issues)** - Bug reports and feature requests\n- π **[MCP Documentation](https://modelcontextprotocol.io/)** - Model Context Protocol specification\n- βοΈ **[React Native Docs](https://reactnative.dev/)** - Official React Native documentation\n\n### Contributing\n\nWe welcome contributions from the React Native community. Please review our [Contributing Guidelines](CONTRIBUTING.md) for development standards and submission processes.\n\n### License\n\nThis project is licensed under the [MIT License](LICENSE). See the license file for detailed terms and conditions.\n\n---\n\n\n\n**Professional React Native Development with Expert-Level Remediation**\n\n*Empowering development teams to build secure, performant, and accessible mobile applications with automated expert-level code fixes*\n\nπ **v0.0.1 - First Release!**\n\n[Get Started](https://www.npmjs.com/package/@divagnz/mcp-react-native-expo) β’ [Documentation](https://github.com/Divagnz/mcp-react-native-expo) β’ [Community](https://github.com/Divagnz/mcp-react-native-expo/issues)\n\n
\n\n---\n\n## π What's New in This Fork\n\nThis project is a significantly enhanced fork of [@mrnitro360/react-native-mcp-guide](https://github.com/MrNitro360/React-Native-MCP). We've transformed the original foundation into an enterprise-grade development companion with expert-level automation.\n\n### Major Additions & Enhancements\n\n#### 1. π§ Expert Code Remediation System\n\n**Original:** Basic code analysis\n**This Fork:** Production-ready automatic fixes\n\n- **`remediate_code` tool** - Automatically fixes security vulnerabilities, performance issues, and code quality problems\n- **`refactor_component` tool** - Comprehensive component modernization with hooks, TypeScript, and performance optimization\n- **Automatic fixes include:**\n - Security: Hardcoded secrets β environment variables, HTTP β HTTPS upgrades\n - Performance: Memory leak cleanup, ScrollView β FlatList optimization, StyleSheet extraction\n - Quality: TypeScript interface generation, React.memo wrapping, prop validation\n - Best practices: Inline styles β StyleSheet, proper cleanup in useEffect\n\n#### 2. ποΈ Enterprise Architecture\n\n**Original:** Single-file implementation\n**This Fork:** Modular service-based architecture\n\n- **Dependency injection** with clean separation of concerns\n- **Advanced LRU caching** with intelligent eviction and performance optimization\n- **Structured logging** with Winston, circuit breaker patterns, and retry mechanisms\n- **Comprehensive testing** - 735+ tests (from ~0 tests in original)\n - 91.38% branch coverage\n - 78.95% line coverage\n - Unit, integration, and edge case testing\n - Jest with Testing Library integration\n\n#### 3. π¦ Expanded Tool Suite\n\n**Original:** ~8 basic analysis tools\n**This Fork:** 17 specialized professional tools\n\n**New Tools Added:**\n- `remediate_code` - Expert-level automatic code fixing\n- `refactor_component` - Advanced component modernization\n- `analyze_codebase_comprehensive` - Multi-dimensional analysis with auto-fix suggestions\n- `analyze_codebase_performance` - Performance profiling with automatic optimizations\n- `generate_component_test` - Automated test suite generation\n- `analyze_test_coverage` - Coverage analysis with improvement strategies\n- `analyze_testing_strategy` - Testing approach evaluation and recommendations\n- `upgrade_packages` - Intelligent package upgrades with compatibility checking\n- `resolve_dependencies` - Dependency conflict resolution\n- `audit_packages` - Security vulnerability auditing with auto-fix\n\n#### 4. π§ͺ Advanced Testing Capabilities\n\n**Original:** No testing infrastructure\n**This Fork:** Industry-standard testing suite\n\n- **Automated test generation** with Jest and React Native Testing Library\n- **Multiple test frameworks** - Detox, Maestro, jest-axe integration\n- **Coverage analysis** with detailed improvement strategies\n- **Testing strategy evaluation** - Unit, integration, E2E recommendations\n- **Accessibility testing** - WCAG 2.1 AA compliance checking\n\n#### 5. π‘οΈ Security & Performance\n\n**Original:** Basic code scanning\n**This Fork:** Expert remediation with automatic fixes\n\n- **Security auditing** - Vulnerability detection with automatic remediation\n - Hardcoded secrets detection and environment variable conversion\n - Sensitive logging sanitization\n - HTTP to HTTPS upgrades\n- **Performance optimization** - Memory and rendering analysis with fixes\n - Memory leak detection and cleanup code generation\n - List rendering optimization (ScrollView β FlatList)\n - Bundle size analysis and code splitting suggestions\n- **Code quality** - Complexity analysis with refactoring implementation\n - Cyclomatic complexity reduction\n - Code duplication detection and extraction\n - Maintainability metrics with actionable fixes\n\n#### 6. π CI/CD & Automation\n\n**Original:** Manual deployment\n**This Fork:** Fully automated workflows\n\n- **GitHub Actions** - Automated PR checks, testing, and deployment\n- **Automated version management** - Semantic versioning with auto-increment\n- **NPM publishing** - Continuous deployment on merge to main\n- **Pre-commit hooks** - Husky with lint-staged for code quality\n- **Quality gates** - Build validation, testing, and linting before deployment\n\n#### 7. π Comprehensive Documentation\n\n**Original:** Basic README\n**This Fork:** Enterprise-grade documentation\n\n- **6 expert prompt templates** - Structured development workflows\n- **5 resource libraries** - Complete React Native documentation and best practices\n- **Real-world examples** - Before/after code with detailed explanations\n- **Troubleshooting guides** - Common issues with solutions\n- **Contributing guidelines** - Comprehensive development standards\n- **Pain points analysis** - Real-world usage tracking and improvement roadmap\n\n### Comparison Summary\n\n| Feature | Original Fork | This Enhanced Fork |\n|---------|---------------|-------------------|\n| **Tools** | ~8 basic tools | 17 specialized professional tools |\n| **Testing** | No tests | 735+ comprehensive tests (91.38% branch coverage) |\n| **Architecture** | Single file | Modular service-based with DI |\n| **Code Fixes** | Manual only | Automatic expert-level remediation |\n| **Security** | Detection only | Detection + automatic fixes |\n| **Performance** | Analysis only | Analysis + automatic optimization |\n| **CI/CD** | None | Full GitHub Actions automation |\n| **Documentation** | Basic | Enterprise-grade with examples |\n| **Caching** | None | Advanced LRU with intelligent eviction |\n| **Error Handling** | Basic | Circuit breaker + retry mechanisms |\n\n### Impact Metrics\n\n- **Productivity boost:** Automatic fixes reduce manual coding by ~60%\n- **Code quality:** 100% TypeScript with comprehensive type safety\n- **Test coverage:** From 0% to 91.38% branch coverage\n- **Security:** Automatic remediation of vulnerabilities\n- **Development time:** Expert-level solutions in seconds, not hours\n\n### Roadmap Additions\n\n**Planned for v0.1.0:**\n- 15 Expo CLI tools (dev server, EAS builds, OTA updates)\n- Enhanced session management\n- Smart log filtering\n\n**Future releases:**\n- ADB (Android Debug Bridge) integration\n- iOS development tools (simulator, provisioning, TestFlight)\n- Multi-platform workflow automation\n\n---\n\n## π Acknowledgments\n\nThis project builds upon the excellent work of the React Native and MCP communities:\n\n- **[React Native Team](https://reactnative.dev/)** - For creating and maintaining the outstanding React Native framework that makes cross-platform mobile development accessible and powerful.\n\n- **[@mrnitro360](https://github.com/MrNitro360)** - Original author of [react-native-mcp-guide](https://github.com/MrNitro360/React-Native-MCP), which provided the foundation for this enhanced server. Thank you for pioneering React Native MCP integration.\n\n- **[Expo Team](https://expo.dev/)** - For building the incredible Expo ecosystem that simplifies React Native development and enables rapid iteration with tools like EAS Build and OTA updates.\n\n- **[Anthropic](https://www.anthropic.com/)** - For developing the Model Context Protocol (MCP) and Claude, enabling powerful AI-assisted development workflows that enhance developer productivity.\n\nSpecial thanks to the broader React Native community for continuous innovation, comprehensive documentation, and countless contributions that make mobile development better every day.\n","readmeFilename":"README.md","_rev":"1-bc920da890e26ea1d012bd3b6efd38f9"}