ios-vibe-mcp 🚀

Transform any idea into a complete iOS application using AI in Cursor. Works with any LLM (Claude, GPT-4, Gemini, etc.).

ios-vibe-mcp is an MCP (Model Context Protocol) server designed for vibe-coding iOS apps with SwiftUI. It generates project specs, architecture plans, coding steps, UI/UX guidance and test strategies — all as Markdown files.

Note: The tool is currently in MVP stage. The GitHub repository is private for now.

🚀 Quick Start

Installation

Install and run with npx:

npm i ios-vibe-mcp01xx

Add to Cursor

Add the following configuration to your Cursor mcp.json file and restart Cursor:

{
  "mcpServers": {
    "ios-vibe-factory": {
      "command": "npx",
      "args": ["-y", "ios-vibe-mcp01"]
    }
  }
}

🧠 Basic Usage (No JSON Required)

You don’t need to write JSON. Just type commands in plain text inside Cursor chat.

1. Generate project blueprint

plan: SwiftUI offline-first notes app with CoreData

Creates: PROJECT_BLUEPRINT.md, TODO.md, IOS_RULES.md, RUNBOOK.md, BACKLOG.md.

2. Create architecture plan

architecture

Creates: STAGE_ARCHITECTURE.md.

3. Generate coding plan

coding

Creates: STAGE_CODING.md.

4. Generate UI/UX guide

uiux

Creates: STAGE_UIUX.md.

5. Generate test strategy

test

Creates: STAGE_TEST.md.

🛠️ Commands

• plan: <idea> — Generates full product blueprint (PROJECT_BLUEPRINT.md)
• architecture — Defines app structure & data layer (STAGE_ARCHITECTURE.md)
• coding — Feature-by-feature coding roadmap (STAGE_CODING.md)
• uiux — UX/UI checklist & design rules (STAGE_UIUX.md)
• test — Testing strategy & critical flows (STAGE_TEST.md)
• review — Consistency checks (REVIEW_REPORT.md)
• ship — App Store readiness checklist (SHIP_CHECKLIST.md)

🌟 Key Features

• Command-based workflow for building iOS apps
• SwiftUI-first architecture
• Enforces MVVM + Repository pattern
• Offline-first behavior (no Firebase by default)

Generates: product spec, architecture spec, coding roadmap, UI/UX guide, test plan, App Store checklist.

🏗️ How It Works

Workflow: plan → architecture → coding → uiux → test → review → ship — each step generates a Markdown spec file and locks scope for the next step.

Files Generated

• PROJECT_BLUEPRINT.md — Full product definition
• TODO.md — Task list for entire app
• IOS_RULES.md — Enforced iOS architecture rules
• RUNBOOK.md — How to run and debug
• BACKLOG.md — Scope lock for new ideas
• STAGE_ARCHITECTURE.md — Folder structure + data layer
• STAGE_CODING.md — Feature-by-feature coding plan
• STAGE_UIUX.md — UX rules & components
• STAGE_TEST.md — Testing strategy
• SHIP_CHECKLIST.md — App Store readiness

📱 Platforms Supported

• iOS (SwiftUI)

Storage:

• CoreData (default)
• SwiftData (experimental)

📋 Requirements

• Node.js 18+
• Cursor IDE (with MCP enabled)
• Any LLM (Claude, GPT-4, Gemini, etc.)
• macOS + Xcode (for iOS development)

👥 Perfect For

• Beginners — Turn ideas into real iOS apps
• Developers — Speed up SwiftUI development
• Startups — Rapid MVP creation
• Students — Learn by building real apps
• Indie hackers — Vibe coding workflows

🧪 Example Workflow

plan: expense tracker app
architecture
coding
uiux
test
ship

🛡️ License

MIT

👤 Author

Talha Pakdil

GitHub: https://github.com/talhapakdil7

LinkedIn: https://www.linkedin.com/in/talhapakdil