MCP Mobile Server — ИИ-инструменты для мобильной разработки под Android, iOS и Flutter

36 инструментов для автоматизации мобильной разработки, готовых к использованию в Claude Desktop и любом ИИ-клиенте с поддержкой MCP.

от Cristiano Arêdes

Что это такое?

MCP Mobile Server — это сервер Model Context Protocol, который предоставляет ИИ-ассистентам прямой структурированный доступ к вашему инструментарию мобильной разработки. Он связывает Claude Desktop (и другие MCP-клиенты) с рабочими процессами Flutter, Android SDK и iOS/Xcode с помощью 36 типизированных инструментов и 10 высокоуровневых «супер-инструментов», которые координируют комплексные многошаговые процессы.

Вместо переключения между терминалами и документацией, вы описываете желаемое действие на естественном языке, а сервер выполняет нужные команды — со встроенной проверкой, обработкой ошибок и стратегиями восстановления.

Поддерживаемые платформы: Android · iOS · Flutter · macOS · Linux · Windows (частично)

Related MCP server: Specter MCP

Возможности

Супер-инструменты — полные рабочие процессы в одном вызове

Встроенная безопасность

• Все команды оболочки проверяются по «белому списку» перед выполнением

• Детектор опасных шаблонов блокирует попытки инъекций

• Защита от обхода путей (path traversal) для всех файловых аргументов

• Проверка входных данных во время выполнения через Zod

• Настраиваемые тайм-ауты для длительных процессов

Требования

Вам нужны только SDK для тех платформ, с которыми вы работаете. Сервер запускается и предоставляет инструменты, даже если некоторые SDK отсутствуют.

Установка

Вариант 1 — Запуск через npx (установка не требуется)

npx @cristianoaredes/mcp-mobile-server

Вариант 2 — Глобальная установка

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

Вариант 3 — Сборка из исходного кода

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

Настройка Claude Desktop

Добавьте сервер в файл конфигурации 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"]
    }
  }
}

После сохранения перезапустите Claude Desktop. 36 инструментов мобильной разработки появятся автоматически.

Примеры использования

Проверка окружения

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

Сервер обменивается данными через stdio с использованием JSON-RPC 2.0, стандартного транспорта MCP.

Вклад в проект

# 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

См. CONTRIBUTING.md для ознакомления с правилами и docs/ для получения полного набора документации.

Документация

Устранение неполадок

Flutter не найден

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

Android SDK не настроен

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

Claude Desktop не распознает сервер

1. Убедитесь, что путь к файлу конфигурации правильный для вашей ОС

2. Проверьте валидность JSON (отсутствие лишних запятых)

3. Полностью перезапустите Claude Desktop

4. Спросите Claude: "Use health_check to verify the mobile server"

Лицензия

MIT — бесплатно для использования, изменения и распространения.

Сообщить об ошибке · Запросить функцию · Полная документация