采用FastMCP 2.0和简洁架构构建的现代iOS自动化服务器

一台基于FastMCP 2.0构建的iOS自动化MCP服务器，具备干净的模块化架构，实现完整的平台隔离。准备好跨平台扩展，iOS专用和共享组件得到妥善分离。

📺 演示视频

** 🎬 观看完整演示**：移动自动化iOS MCP服务器运行

✨ 特色

• 🚀 FastMCP 2.0 - 现代以 Python 为先的 MCP 实现
• 🌐 云部署 - 准备用于铁路、Heroku或其他平台
• 📱 Real iOS Automation - Appium + WebDriverAgent 集成
• 🏗️ 清洁模块化架构 - 完整的平台隔离与SOLID原则
• 🔄 跨平台准备 - 面向未来Android或其他平台的共享工具
• 🎨 美丽的日志 - 带表情符号的彩色控制台输出
• 🔧 类型安全 - 全书中详尽的类型提示
• 🔌 可扩展 - 带有模块化配置的插件式工具系统
• 📦 零代码重复 - 带有共享工具的 DRY 原则

🚀 快速启动

选项1：远程服务器（推荐）

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