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

$3

Install and run with npx:

``bash
npm i ios-vibe-mcp01xx
`

$3

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

`json
{
"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: — 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.

$3

- 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