Servidor Móvil MCP — Desarrollo móvil con IA para Android, iOS y Flutter

36 herramientas para la automatización del desarrollo móvil, listas para usar dentro de Claude Desktop y cualquier cliente de IA compatible con MCP.

por Cristiano Arêdes

¿Qué es esto?

MCP Mobile Server es un servidor del Protocolo de Contexto de Modelo (MCP) que brinda a los asistentes de IA acceso directo y estructurado a su cadena de herramientas de desarrollo móvil. Conecta Claude Desktop (y otros clientes MCP) con los flujos de trabajo de Flutter, Android SDK e iOS/Xcode a través de 36 herramientas tipadas y 10 "superherramientas" de alto nivel que orquestan flujos de trabajo completos de varios pasos.

En lugar de cambiar entre terminales y documentación, usted describe lo que desea en lenguaje natural y el servidor ejecuta los comandos correctos, con validación, manejo de errores y estrategias de respaldo integradas.

Plataformas compatibles: Android · iOS · Flutter · macOS · Linux · Windows (parcial)

Related MCP server: Specter MCP

Características

Superherramientas — flujos de trabajo completos en una sola llamada

Seguridad integrada

• Todos los comandos de shell se validan contra una lista de permitidos antes de su ejecución

• La detección de patrones peligrosos bloquea intentos de inyección

• Protección contra recorrido de rutas en todos los argumentos de archivo

• Validación de entrada en tiempo de ejecución mediante Zod

• Tiempos de espera configurables en procesos de larga duración

Requisitos

Solo necesita los SDK para las plataformas en las que trabaja. El servidor inicia y sirve las herramientas incluso cuando faltan algunos SDK.

Instalación

Opción 1 — Ejecutar con npx (no requiere instalación)

npx @cristianoaredes/mcp-mobile-server

Opción 2 — Instalar globalmente

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

Opción 3 — Compilar desde el código fuente

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

Configuración de Claude Desktop

Agregue el servidor a su archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

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

Reinicie Claude Desktop después de guardar. Las 36 herramientas de desarrollo móvil aparecerán automáticamente.

Ejemplos de uso

Compruebe su entorno

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

Run flutter_doctor to check my Flutter setup

Trabaje con dispositivos

List all connected Android devices and iOS simulators

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

Compile y pruebe

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

Build release versions for Android and iOS

Solucione problemas de compilación

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

Valide la instalación desde la línea de comandos

# After building from source:
npm run mcp:validate

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

Estructura del proyecto

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

El servidor se comunica a través de stdio usando JSON-RPC 2.0, el transporte estándar de MCP.

Contribución

# 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

Consulte CONTRIBUTING.md para conocer las pautas y docs/ para el conjunto completo de documentación.

Documentación

Solución de problemas

Flutter no encontrado

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

Android SDK no configurado

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

No hay dispositivos disponibles

# 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"

Claude Desktop no reconoce el servidor

1. Verifique que la ruta del archivo de configuración sea correcta para su SO

2. Compruebe que el JSON sea válido (sin comas finales)

3. Reinicie Claude Desktop por completo

4. Pregunte a Claude: "Use health_check to verify the mobile server"

Licencia

MIT — libre de usar, modificar y distribuir.

Reportar un error · Solicitar una característica · Documentación completa