npx @cristianoaredes/mcp-mobile-server

npm install -g @cristianoaredes/mcp-mobile-server
mcp-mobile-server

git clone https://github.com/cristianoaredes/mcp-mobile-server.git
cd mcp-mobile-server
npm install
npm run build
npm start

{
  "mcpServers": {
    "mobile-dev": {
      "command": "npx",
      "args": ["@cristianoaredes/mcp-mobile-server"]
    }
  }
}

Use the health_check tool to verify the mobile development server is working

Run flutter_doctor to check my Flutter setup

List all connected Android devices and iOS simulators

Start a Flutter development session with hot reload on the best available device

Run the full test suite for my Flutter project at /path/to/project

Build release versions for Android and iOS

My Flutter app won't build. Use flutter_fix_common_issues to diagnose and fix it.

# After building from source:
npm run mcp:validate

# Expected output:
# ✅ Server configuration is valid
# ✅ 36 tools registered

src/
  server.ts          # MCP server entry point
  tools/
    android.ts       # Android SDK tools
    ios.ts           # iOS / Xcode / Simulator tools
    flutter.ts       # Flutter SDK tools
    super-tools.ts   # High-level workflow automation
    setup-tools.ts   # Environment setup tools
  utils/
    process.ts       # Process execution and tracking
    security.ts      # Command validation and sandboxing
    fallbacks.ts     # Fallback strategies (ADB → native-run, etc.)
    tool-categories.ts # Tool registry

# Clone and install
git clone https://github.com/cristianoaredes/mcp-mobile-server.git
cd mcp-mobile-server
npm install

# Run in development mode (watch)
npm run dev

# Run tests
npm test

# Run linter and full CI check
npm run ci

# Run the automated setup tool
# In Claude Desktop: "Use flutter_setup_environment to install Flutter"

# In Claude Desktop: "Use android_sdk_setup to configure Android"

# List what's available
# "Use android_list_emulators and ios_list_simulators to see available devices"

# Or start a new one
# "Use android_start_emulator to launch an Android emulator"