{"_id":"@cristianoaredes/mcp-mobile-server","_rev":"5-fc75d4a22f34ce51aaa5fb008136b952","name":"@cristianoaredes/mcp-mobile-server","dist-tags":{"latest":"2.3.0"},"versions":{"1.0.0":{"name":"@cristianoaredes/mcp-mobile-server","version":"1.0.0","keywords":["mcp","mobile","android","ios","flutter","development","cli"],"author":{"name":"MCP Mobile Server Contributors"},"license":"MIT","_id":"@cristianoaredes/mcp-mobile-server@1.0.0","maintainers":[{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"}],"homepage":"https://github.com/cristianoaredes/mcp-mobile-server#readme","bugs":{"url":"https://github.com/cristianoaredes/mcp-mobile-server/issues"},"bin":{"mcp-mobile-server":"dist/server.js"},"mcp":{"transport":"stdio","capabilities":{"tools":true,"prompts":false,"resources":false}},"dist":{"shasum":"1bc51417c03157232bcb69274a53edfddb7ab649","tarball":"https://registry.npmjs.org/@cristianoaredes/mcp-mobile-server/-/mcp-mobile-server-1.0.0.tgz","fileCount":79,"integrity":"sha512-IktraoQogtqbeL8cpDVElcnUUc9A9RoIPW0ZsIE0zu4gcqH3n4i9Mqlcl5jN7oQtZ04pVj4/Wl35pDNCdvgeQg==","signatures":[{"sig":"MEQCIFt2+8oHWCoK0VFfZpA/2MJRf1U77+OkVSkHnIbo25qNAiAY6+m7MqqL0ypQDDIbjIjx3AW4klrS28XXA816FJakrw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":541602},"main":"dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"75852c0d77c63948b0c3350e09f8a9433e2777fb","scripts":{"ci":"npm run lint && npm run build && npm run test:unit && npm run test:integration","dev":"tsx watch src/server.ts","lint":"eslint src tests --ext .ts","test":"vitest","build":"tsc","start":"node dist/server.js","format":"prettier --write src/**/*.ts tests/**/*.ts","test:e2e":"vitest run tests/e2e","validate":"tsx scripts/validate-tools.ts","test:unit":"vitest run tests/unit","test:watch":"vitest watch","mcp:validate":"node dist/server.js validate","test:coverage":"vitest run --coverage","test:integration":"vitest run tests/integration"},"_npmUser":{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"},"repository":{"url":"git+https://github.com/cristianoaredes/mcp-mobile-server.git","type":"git"},"_npmVersion":"10.9.2","description":"Native MCP Server for Mobile Development (Android, iOS, Flutter)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.4","execa":"^8.0.1","which":"^4.0.0","@modelcontextprotocol/sdk":"^0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.6.0","eslint":"^8.54.0","vitest":"^1.0.0","prettier":"^3.1.0","typescript":"^5.3.2","@types/node":"^20.10.0","@types/which":"^3.0.3","@typescript-eslint/parser":"^6.13.1","@typescript-eslint/eslint-plugin":"^6.13.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-mobile-server_1.0.0_1756258071388_0.3413927882467076","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@cristianoaredes/mcp-mobile-server","version":"1.1.0","keywords":["mcp","mobile","android","ios","flutter","development","cli"],"author":{"name":"MCP Mobile Server Contributors"},"license":"MIT","_id":"@cristianoaredes/mcp-mobile-server@1.1.0","maintainers":[{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"}],"homepage":"https://github.com/cristianoaredes/mcp-mobile-server#readme","bugs":{"url":"https://github.com/cristianoaredes/mcp-mobile-server/issues"},"bin":{"mcp-mobile-server":"dist/server.js"},"mcp":{"transport":"stdio","capabilities":{"tools":true,"prompts":false,"resources":false}},"dist":{"shasum":"5455dbf42c82b0faa8d5c03b1e328309658d3498","tarball":"https://registry.npmjs.org/@cristianoaredes/mcp-mobile-server/-/mcp-mobile-server-1.1.0.tgz","fileCount":90,"integrity":"sha512-JxlLa9CYl+8KAvFQss8oiioMisi12fs2PrIfSRdW8sJa5UehqdQw1wovgyvLEm5gzC66anK7zUuuVFc7Jw5jZg==","signatures":[{"sig":"MEUCICZvkyXvmZMY5oU2Fb6Mv6VwF8z3Q0Rq3Arv6Kr+QTgrAiEAxUtrg63WLRowc4A63WTJqGbcZbjcXa2pvb93sHVfuYk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":623319},"main":"dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"20fe58ac2da7351b1c3f9d89d6519fb9495bcd8f","scripts":{"ci":"npm run lint && npm run build && npm run test:unit && npm run test:integration","dev":"tsx watch src/server.ts","lint":"eslint src tests --ext .ts","test":"vitest","build":"tsc","start":"node dist/server.js","format":"prettier --write src/**/*.ts tests/**/*.ts","test:e2e":"vitest run tests/e2e","validate":"tsx scripts/validate-tools.ts","test:unit":"vitest run tests/unit","test:watch":"vitest watch","mcp:validate":"node dist/server.js validate","test:coverage":"vitest run --coverage","test:integration":"vitest run tests/integration"},"_npmUser":{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"},"repository":{"url":"git+https://github.com/cristianoaredes/mcp-mobile-server.git","type":"git"},"_npmVersion":"10.9.2","description":"Native MCP Server for Mobile Development with 54+ tools, fallback system, and native-run support (Android, iOS, Flutter)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.4","execa":"^8.0.1","which":"^4.0.0","@modelcontextprotocol/sdk":"^0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.6.0","eslint":"^8.54.0","vitest":"^1.0.0","prettier":"^3.1.0","typescript":"^5.3.2","@types/node":"^20.10.0","@types/which":"^3.0.3","@typescript-eslint/parser":"^6.13.1","@typescript-eslint/eslint-plugin":"^6.13.1"},"optionalDependencies":{"native-run":"^2.0.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-mobile-server_1.1.0_1756263080901_0.5690119319948068","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@cristianoaredes/mcp-mobile-server","version":"2.1.0","keywords":["mcp","mobile","android","ios","flutter","development","cli"],"author":{"name":"MCP Mobile Server Contributors"},"license":"MIT","_id":"@cristianoaredes/mcp-mobile-server@2.1.0","maintainers":[{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"}],"homepage":"https://github.com/cristianoaredes/mcp-mobile-server#readme","bugs":{"url":"https://github.com/cristianoaredes/mcp-mobile-server/issues"},"bin":{"mcp-mobile-server":"dist/server.js"},"mcp":{"transport":"stdio","capabilities":{"tools":true,"prompts":false,"resources":false}},"dist":{"shasum":"a3a72c5c2e8e4f283650c57c9e8ae19e194e6161","tarball":"https://registry.npmjs.org/@cristianoaredes/mcp-mobile-server/-/mcp-mobile-server-2.1.0.tgz","fileCount":106,"integrity":"sha512-q+nr0frGa9SCjMgjXRPLbEVTdMqUYhbtXTPUcXZQbcvbDYEXL+7npVUgd3aLq2QtaUjvwHJsjn/EY0ajrBvgUA==","signatures":[{"sig":"MEQCIH8xCjZ3Rp0Mss+kA4Y9NmOyp5GusCgGHrXxcpTCq3dOAiA4G1FICzbIW7do7cZIPynC5pH2UCoIGK6vA2iRORsN9A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":736625},"main":"dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"713c2f1d62d0e673cd6e83d122b2503a5d7ce407","scripts":{"ci":"npm run lint && npm run build && npm run test:unit && npm run test:integration","dev":"tsx watch src/server.ts","lint":"eslint src tests --ext .ts","test":"vitest","build":"tsc","start":"node dist/server.js","format":"prettier --write src/**/*.ts tests/**/*.ts","test:e2e":"vitest run tests/e2e","validate":"tsx scripts/validate-tools.ts","test:unit":"vitest run tests/unit","test:watch":"vitest watch","mcp:validate":"node dist/server.js validate","test:coverage":"vitest run --coverage","test:integration":"vitest run tests/integration"},"_npmUser":{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"},"repository":{"url":"git+https://github.com/cristianoaredes/mcp-mobile-server.git","type":"git"},"_npmVersion":"10.9.2","description":"Native MCP Server for Mobile Development with 34 tools including 10 intelligent super-tools for complete workflows (Android, iOS, Flutter)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.4","execa":"^8.0.1","which":"^4.0.0","@modelcontextprotocol/sdk":"^0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.6.0","eslint":"^8.54.0","vitest":"^1.0.0","prettier":"^3.1.0","typescript":"^5.3.2","@types/node":"^20.10.0","@types/which":"^3.0.3","@typescript-eslint/parser":"^6.13.1","@typescript-eslint/eslint-plugin":"^6.13.1"},"optionalDependencies":{"native-run":"^2.0.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-mobile-server_2.1.0_1756314388194_0.45953640083115976","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@cristianoaredes/mcp-mobile-server","version":"2.2.0","keywords":["mcp","mobile","android","ios","flutter","development","cli"],"author":{"name":"MCP Mobile Server Contributors"},"license":"MIT","_id":"@cristianoaredes/mcp-mobile-server@2.2.0","maintainers":[{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"}],"homepage":"https://github.com/cristianoaredes/mcp-mobile-server#readme","bugs":{"url":"https://github.com/cristianoaredes/mcp-mobile-server/issues"},"bin":{"mcp-mobile-server":"dist/server.js"},"mcp":{"transport":"stdio","capabilities":{"tools":true,"prompts":false,"resources":false}},"dist":{"shasum":"d78158f280c2093a69688e2306e039aa84db6f17","tarball":"https://registry.npmjs.org/@cristianoaredes/mcp-mobile-server/-/mcp-mobile-server-2.2.0.tgz","fileCount":112,"integrity":"sha512-DaV8OCsL/jr2oNO60IXAqE0fsa5soAAb0T9odSmol0cuGG6MTevge5z3+evlKkI92PJrojYuJzRLowS4ZnGfTg==","signatures":[{"sig":"MEUCIAGhUze5ZEe3opyBGuTpv4hO57VHJt4al6LsO1zjYSaiAiEAu/2oNaJhPN0+QTdQFijFzNTY3L5Q2/NuF9dZ9PbZwwc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":798415},"main":"dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"713c2f1d62d0e673cd6e83d122b2503a5d7ce407","scripts":{"ci":"npm run lint && npm run build && npm run test:unit && npm run test:integration","dev":"tsx watch src/server.ts","lint":"eslint src tests --ext .ts","test":"vitest","build":"tsc","start":"node dist/server.js","format":"prettier --write src/**/*.ts tests/**/*.ts","test:e2e":"vitest run tests/e2e","validate":"tsx scripts/validate-tools.ts","test:unit":"vitest run tests/unit","test:watch":"vitest watch","mcp:validate":"node dist/server.js validate","test:coverage":"vitest run --coverage","test:integration":"vitest run tests/integration"},"_npmUser":{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"},"repository":{"url":"git+https://github.com/cristianoaredes/mcp-mobile-server.git","type":"git"},"_npmVersion":"10.9.2","description":"Native MCP Server for Mobile Development with 36 tools including Flutter/Android SDK automated setup and 10 intelligent super-tools (Android, iOS, Flutter)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.4","execa":"^8.0.1","which":"^4.0.0","@modelcontextprotocol/sdk":"^0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.6.0","eslint":"^8.54.0","vitest":"^1.0.0","prettier":"^3.1.0","typescript":"^5.3.2","@types/node":"^20.10.0","@types/which":"^3.0.3","@typescript-eslint/parser":"^6.13.1","@typescript-eslint/eslint-plugin":"^6.13.1"},"optionalDependencies":{"native-run":"^2.0.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-mobile-server_2.2.0_1756327151840_0.49268664708110776","host":"s3://npm-registry-packages-npm-production"}},"2.3.0":{"name":"@cristianoaredes/mcp-mobile-server","version":"2.3.0","description":"Native MCP Server for Mobile Development with 36 tools including Flutter/Android SDK automated setup and 10 intelligent super-tools (Android, iOS, Flutter)","type":"module","main":"dist/server.js","bin":{"mcp-mobile-server":"dist/server.js"},"scripts":{"build":"tsc","dev":"tsx watch src/server.ts","start":"node dist/server.js","validate":"tsx scripts/validate-tools.ts","mcp:validate":"node dist/server.js validate","test":"vitest","test:unit":"vitest run tests/unit","test:integration":"vitest run tests/integration","test:e2e":"vitest run tests/e2e","test:watch":"vitest watch","test:coverage":"vitest run --coverage","lint":"eslint src tests --ext .ts","format":"prettier --write src/**/*.ts tests/**/*.ts","ci":"npm run lint && npm run build && npm run test:unit && npm run test:integration"},"keywords":["mcp","mobile","android","ios","flutter","development","cli"],"author":{"name":"MCP Mobile Server Contributors"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/cristianoaredes/mcp-mobile-server.git"},"homepage":"https://github.com/cristianoaredes/mcp-mobile-server#readme","bugs":{"url":"https://github.com/cristianoaredes/mcp-mobile-server/issues"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^0.4.0","execa":"^8.0.1","zod":"^3.22.4","which":"^4.0.0"},"optionalDependencies":{"native-run":"^2.0.1"},"devDependencies":{"@types/node":"^20.10.0","@types/which":"^3.0.3","@typescript-eslint/eslint-plugin":"^6.13.1","@typescript-eslint/parser":"^6.13.1","eslint":"^8.54.0","prettier":"^3.1.0","tsx":"^4.6.0","typescript":"^5.3.2","vitest":"^1.0.0"},"engines":{"node":">=18.0.0"},"mcp":{"transport":"stdio","capabilities":{"tools":true,"resources":false,"prompts":false}},"_id":"@cristianoaredes/mcp-mobile-server@2.3.0","gitHead":"8371b4831d9957d8808c306f084f8b3af6b7a254","types":"./dist/server.d.ts","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-nw5vR1/qEmIaEvpQJrN12v5hRXA3Pw63IQHhfhLrz5kUTLvsM/KKCUtfiNTuTZ+kA6rHuJnuFpPIdEZlza/z7Q==","shasum":"f57dc684c47218331e75a24e570253dc6d07d5e6","tarball":"https://registry.npmjs.org/@cristianoaredes/mcp-mobile-server/-/mcp-mobile-server-2.3.0.tgz","fileCount":112,"unpackedSize":798415,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFlvlR1ERqXDm51mIr0XgsGTulL4F/7rR0kcn9Vw5R81AiA0tyXn8bOOg2HEUK5oo4j7Q49UMERNqhlANj0syUKWtg=="}]},"_npmUser":{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"},"directories":{},"maintainers":[{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-mobile-server_2.3.0_1756328623765_0.5263556098105293"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-27T01:27:51.322Z","modified":"2025-08-27T21:03:44.275Z","1.0.0":"2025-08-27T01:27:51.608Z","1.1.0":"2025-08-27T02:51:21.082Z","2.1.0":"2025-08-27T17:06:28.400Z","2.2.0":"2025-08-27T20:39:12.096Z","2.3.0":"2025-08-27T21:03:44.115Z"},"bugs":{"url":"https://github.com/cristianoaredes/mcp-mobile-server/issues"},"author":{"name":"MCP Mobile Server Contributors"},"license":"MIT","homepage":"https://github.com/cristianoaredes/mcp-mobile-server#readme","keywords":["mcp","mobile","android","ios","flutter","development","cli"],"repository":{"type":"git","url":"git+https://github.com/cristianoaredes/mcp-mobile-server.git"},"description":"Native MCP Server for Mobile Development with 36 tools including Flutter/Android SDK automated setup and 10 intelligent super-tools (Android, iOS, Flutter)","maintainers":[{"name":"cristianoaredes","email":"cristianoaredes@icloud.com"}],"readme":"# 🚀 MCP Mobile Server\n\n
\n \"MCP\n \n

Supercharge Your Mobile Development with AI-Powered Tools

\n \n

\n \"NPM\n \"License\"\n \"MCP\n \"Platforms\"\n \"Tools\"\n

\n\n

\n 36 powerful tools for mobile development • 10 intelligent super-tools • Cross-platform support\n

\n
\n\n---\n\n## 🌟 Why MCP Mobile Server?\n\nMCP Mobile Server transforms your AI assistant into a **mobile development powerhouse**. Whether you're building with Flutter, developing for iOS, or creating Android apps, this server provides seamless integration with Claude Desktop, Windsurf, and other MCP-compatible clients.\n\n### ✨ Key Features\n\n\n\n\n\n\n\n\n\n\n
\n\n**🎯 Intelligent Automation**\n- Smart device selection and management\n- Automated environment setup\n- Self-healing build processes\n- Intelligent error resolution\n\n\n\n**⚡ Developer Productivity**\n- Hot reload development sessions\n- One-command deployments\n- Parallel testing across devices\n- Automated dependency management\n\n
\n\n**🔧 Complete Toolchain**\n- Flutter, Android, and iOS tools\n- Emulator and simulator control\n- Build and test automation\n- Performance profiling\n\n\n\n**🤖 AI-First Design**\n- Built for Claude Desktop\n- Natural language commands\n- Context-aware suggestions\n- Workflow optimization\n\n
\n\n---\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Install globally\nnpm install -g @cristianoaredes/mcp-mobile-server\n\n# Or run directly with npx\nnpx @cristianoaredes/mcp-mobile-server\n```\n\n### Claude Desktop Integration\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n \"mcpServers\": {\n \"mobile-dev\": {\n \"command\": \"npx\",\n \"args\": [\"@cristianoaredes/mcp-mobile-server\"]\n }\n }\n}\n```\n\n### First Steps\n\n```bash\n# Check your environment\nmcp-mobile-server health_check\n\n# Setup Flutter automatically\nmcp-mobile-server flutter_setup_environment --action=full\n\n# Start developing\nmcp-mobile-server flutter_dev_session --cwd=/path/to/project\n```\n\n---\n\n## 🛠️ Available Tools\n\n### 🚀 Super Tools - Complete Workflows\n\nThese intelligent tools combine multiple operations for maximum productivity:\n\n| Tool | Description | Example Use Case |\n|------|-------------|------------------|\n| `flutter_dev_session` | Complete dev environment with hot reload | Start coding immediately with best device auto-selected |\n| `flutter_test_suite` | Run all tests with coverage analysis | CI/CD pipeline integration |\n| `flutter_release_build` | Multi-platform release builds | Deploy to stores with one command |\n| `mobile_device_manager` | Intelligent device orchestration | Auto-start best available device |\n| `flutter_fix_common_issues` | Auto-fix common problems | Resolve build errors automatically |\n\n
\nView All 36 Tools (click to expand)\n\n### 🔧 Core Tools (5)\n- `health_check` - System diagnostics and environment validation\n- `flutter_doctor` - Flutter environment verification\n- `flutter_version` - SDK version management\n- `flutter_list_devices` - Device discovery\n- `android_list_devices` - Android device detection\n\n### 📱 Device Management (9)\n- `native_run_list_devices` - Universal device listing\n- `native_run_install_app` - Cross-platform app installation\n- `ios_list_simulators` - iOS simulator discovery\n- `android_list_emulators` - AVD management\n- `android_create_avd` - Virtual device creation\n- `android_start_emulator` - Emulator lifecycle\n- `android_stop_emulator` - Resource management\n- `ios_shutdown_simulator` - iOS cleanup\n- `flutter_launch_emulator` - Quick emulator start\n\n### ⚡ Development (6)\n- `flutter_run` - Hot reload server\n- `flutter_build` - Production builds\n- `flutter_test` - Test runner\n- `flutter_clean` - Cache management\n- `flutter_pub_get` - Dependencies\n- `android_install_apk` - APK deployment\n\n### 🛠️ Utilities (4)\n- `android_logcat` - Debug logging\n- `android_screenshot` - Screen capture\n- `ios_boot_simulator` - iOS startup\n- `ios_take_screenshot` - iOS capture\n\n### 🔧 Setup Tools (2)\n- `flutter_setup_environment` - Automated Flutter setup\n- `android_sdk_setup` - Android SDK configuration\n\n### 🚀 Advanced Workflows (10)\n- `flutter_performance_profile` - Performance analysis\n- `flutter_deploy_pipeline` - Full deployment\n- `android_full_debug` - Complete debugging\n- `ios_simulator_manager` - iOS orchestration\n- `flutter_inspector_session` - Widget inspection\n\n
\n\n---\n\n## 💡 Real-World Examples\n\n### Example 1: Start a Flutter Project\n```typescript\n// Claude Desktop conversation\nUser: \"Create a new Flutter app and run it\"\nClaude: I'll create a new Flutter app and start the development server.\n\n// Behind the scenes:\nflutter_create({ name: \"my_app\", org: \"com.example\" })\nflutter_dev_session({ cwd: \"./my_app\", preferPhysical: true })\n```\n\n### Example 2: Fix Build Errors\n```typescript\n// Automatic error resolution\nUser: \"My Flutter app won't build\"\nClaude: Let me diagnose and fix the build issues.\n\n// Executes:\nflutter_fix_common_issues({ cwd: \".\", deep: true })\n```\n\n### Example 3: Deploy to Multiple Platforms\n```typescript\n// One-command deployment\nUser: \"Build release versions for Android and iOS\"\nClaude: I'll create optimized release builds for both platforms.\n\n// Runs:\nflutter_release_build({ \n cwd: \".\",\n platforms: [\"apk\", \"appbundle\", \"ipa\"],\n obfuscate: true\n})\n```\n\n---\n\n## 🏗️ Architecture\n\n```mermaid\ngraph TD\n A[Claude Desktop / MCP Client] -->|JSON-RPC| B[MCP Mobile Server]\n B --> C[Tool Registry]\n B --> D[Process Manager]\n B --> E[Security Layer]\n \n C --> F[Flutter Tools]\n C --> G[Android Tools]\n C --> H[iOS Tools]\n C --> I[Super Tools]\n \n F --> J[Flutter SDK]\n G --> K[Android SDK]\n H --> L[Xcode]\n```\n\n### Design Principles\n\n- **🔒 Security First**: All commands validated and sandboxed\n- **⚡ Performance**: Parallel execution and intelligent caching\n- **🎯 Reliability**: Automatic retries and fallback strategies\n- **📦 Modular**: Extensible plugin architecture\n- **🌍 Cross-Platform**: Works on macOS, Linux, and Windows\n\n---\n\n## 📋 Requirements\n\n### Minimum Requirements\n- **Node.js** 18.0+\n- **npm** or **yarn**\n- One of: Flutter, Android SDK, or Xcode\n\n### Recommended Setup\n- **Flutter** 3.0+ for Flutter development\n- **Android Studio** or **Android SDK** for Android\n- **Xcode** 14+ for iOS (macOS only)\n- **VS Code** with Flutter extension\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! See our [Contributing Guide](./docs/CONTRIBUTING.md) for details.\n\n### Development Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/cristianoaredes/mcp-mobile-server.git\n\n# Install dependencies\ncd mcp-mobile-server\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Run tests\nnpm test\n```\n\n---\n\n## 📚 Documentation\n\n| Resource | Description |\n|----------|-------------|\n| [📖 **Full Documentation**](./docs/) | Complete guide and API reference |\n| [🚀 **Quick Start Guide**](./docs/QUICK_START.md) | Get running in 5 minutes |\n| [🔧 **Troubleshooting**](./docs/TROUBLESHOOTING.md) | Common issues and solutions |\n| [🛠️ **Tool Reference**](./docs/TOOLS.md) | Detailed tool documentation |\n| [🏗️ **Architecture**](./docs/ARCHITECTURE.md) | System design and internals |\n\n---\n\n## 🐛 Troubleshooting\n\n
\nCommon Issues\n\n### Flutter not found\n```bash\n# Run the setup tool\nmcp-mobile-server flutter_setup_environment --action=full\n```\n\n### Android SDK not configured\n```bash\n# Configure Android environment\nmcp-mobile-server android_sdk_setup --action=configure\n```\n\n### Permission denied errors\n```bash\n# Check permissions\nls -la $(which mcp-mobile-server)\nchmod +x $(which mcp-mobile-server)\n```\n\n
\n\n---\n\n## 📊 Project Status\n\n| Aspect | Status |\n|--------|--------|\n| **Version** | 2.1.0 |\n| **Stability** | Beta |\n| **Tools** | 36 active |\n| **Test Coverage** | 78% |\n| **Platform Support** | macOS ✅ Linux ✅ Windows ⚠️ |\n\n---\n\n## 📄 License\n\nMIT License - see [LICENSE](./LICENSE) for details.\n\n---\n\n## 🙏 Acknowledgments\n\n- [Model Context Protocol](https://modelcontextprotocol.io) by Anthropic\n- [Flutter](https://flutter.dev) team for the amazing framework\n- All contributors and users of this project\n\n---\n\n
\n\n### 🌟 Support the Project\n\nIf you find this useful, please consider:\n\n[![Star on GitHub](https://img.shields.io/github/stars/cristianoaredes/mcp-mobile-server?style=social)](https://github.com/cristianoaredes/mcp-mobile-server)\n[![Follow on Twitter](https://img.shields.io/twitter/follow/cristianoaredes?style=social)](https://twitter.com/cristianoaredes)\n[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Support-yellow?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/cristianoaredes)\n\n**Built with ❤️ for the mobile development community**\n\n[Report Bug](https://github.com/cristianoaredes/mcp-mobile-server/issues) • [Request Feature](https://github.com/cristianoaredes/mcp-mobile-server/discussions) • [Documentation](./docs/)\n\n
","readmeFilename":"README.md"}