Mobile automation iOS MCP server

Modern iOS automation server built with FastMCP 2.0 and clean architecture

A production-ready iOS automation MCP server built with FastMCP 2.0, featuring clean modular architecture with complete platform segregation. Ready for cross-platform expansion with iOS-specific and shared components properly separated.

📺 Demo Video

🎬 Watch the Complete Demo: Mobile automation iOS MCP server in Action

✨ Features

• 🚀 FastMCP 2.0 - Modern Python-first MCP implementation
• 🌐 Cloud Deployment - Ready for Railway, Heroku, or other platforms
• 📱 Real iOS Automation - Appium + WebDriverAgent integration
• 🏗️ Clean Modular Architecture - Complete platform segregation & SOLID principles
• 🔄 Cross-Platform Ready - Shared utilities for future Android/other platforms
• 🎨 Beautiful Logging - Colored console output with emojis
• 🔧 Type-Safe - Comprehensive type hints throughout
• 🔌 Extensible - Plugin-style tool system with modular configuration
• 📦 Zero Code Duplication - DRY principles with shared utilities

🚀 Quick Start

Option 1: Remote Server (Recommended)

Use the hosted version on Railway - no local setup required:

{
  "mcpServers": {
    "ios-automation-railway": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-server-demo-production.up.railway.app/sse/"
      ]
    }
  }
}

Option 2: Local Development

1. Prerequisites

   • macOS (required for iOS automation)
   • Python 3.11+
   • uv (recommended) or pip
   • Xcode with iOS Simulator
   • Node.js (for Appium)

2. Installation

   git clone https://github.com/iHackSubhodip/mcp-server-demo.git
   cd mcp-server-demo
   
   # Using uv (recommended)
   uv sync
   
   # Or using pip (legacy)
   pip install -e .
   

3. Claude Desktop Configuration

   {
     "mcpServers": {
       "ios-automation-local": {
         "command": "uv",
         "args": ["run", "python", "mobile-automation-mcp-server/fastmcp_server.py"],
         "cwd": "/path/to/mcp-server-demo"
       }
     }
   }
   

🏗️ Architecture

The Mobile automation iOS MCP server features a clean, modular architecture with complete platform segregation achieved through a comprehensive 6-phase refactoring. This design enables maximum maintainability, zero code duplication, and seamless cross-platform expansion.

✨ Architecture Achievements

🎯 Complete Platform Segregation

• Cross-platform utilities isolated in shared/ package
• iOS-specific code contained in platforms/ios/ package
• Clean separation of concerns across all components
• Future-ready for Android in platforms/android/

🔄 DRY Principles Applied

• Shared utilities: Logger, exceptions, command runner
• Base configuration: AppiumConfig, ServerConfig for reuse
• Platform configs: iOS-specific settings separate
• Zero duplication between current/future platforms

🛡️ Maintainable & Extensible

• Self-contained platforms: Each platform completely independent
• Unified interface: Single configuration entry point
• Backward compatible: All existing interfaces preserved
• **Profes

... View full README on GitHub