iOS Spec2Code (ios-sdd-mcp) 🍎

Sadece iOS için Specification-Driven Development MCP sunucusu. Cursor içinde AI ile fikirden spec → plan → task’lara, oradan Swift/SwiftUI uygulamasına gider. SwiftUI first, MVVM first, implementation-first (test zorunlu değil).

Paketi npm’den kurma

npm install -g ios-sdd-mcp

Gereksinimler: Node.js 18+, macOS, Cursor (MCP açık). iOS geliştirme için Xcode gerekir.

Cursor’da nasıl kullanılır?

1. MCP ayarını ekle

Cursor’da Settings → MCP (veya ~/.cursor/mcp.json) dosyasına şunu ekle:

{
  "mcpServers": {
    "ios-sdd-mcp": {
      "command": "sdd-mcp",
      "args": [],
      "env": {
        "PROJECT_ROOT": "${workspaceFolder}"
      }
    }
  }
}

2. Cursor’u yenile

Cursor’u yeniden başlat veya MCP sunucularını yenile. Araçlar listesinde sdd_specify, sdd_plan, sdd_tasks, sdd_implement vb. görünmeli.

3. Komutları kullan

Sohbet içinde sırayla:

| Ne yapmak istiyorsun? | Komut | |------------------------|--------| | Spec oluştur | /sdd_specify "Yapılacaklar listesi uygulaması, SwiftUI ile" | | Plan oluştur | /sdd_plan | | Task’ları oluştur (4 faz, 33 task) | /sdd_tasks | | Faz faz implement et | /sdd_implement phase=1 → phase=2 → phase=3 → phase=4 |

İlk kez kullanıyorsan önce /sdd_implement phase=1 çağrılması önerilir; araç sana adım adım ne yapacağını söyler.

Tüm komutlar

| Komut | Açıklama | |--------|----------| | /sdd_specify | iOS odaklı spec üretir → specs/spec.md | | /sdd_plan | Implementation planı oluşturur → specs/plan.md | | /sdd_tasks | 4 fazda 33 task dosyası üretir | | /sdd_implement phase=X | İlgili fazı çalıştırır (implementation-first) | | /sdd_implement phase=X task=Y | Belirli bir task’ı çalıştırır | | /sdd_workflow | specify → plan → tasks → implement tam zincir | | /sdd_validate_architecture | Implementasyonu spec’e göre doğrular |

Özellikler

• Sadece iOS — Swift/SwiftUI, Xcode; platform her zaman iOS kabul edilir.
• SwiftUI first, MVVM first — Apple HIG, 44pt tap target, SF Symbols, NavigationStack, TabView.
• Implementation-first — Doğrulama: build (xcodebuild) + simulator’da çalıştırma; test yazımı zorunlu değil.
• Cursor MCP — Tüm akış Cursor sohbetinde komutlarla yürür.

Sorun giderme

• Komut bulunamıyor: Terminalde which sdd-mcp yaz. Bir path görüyorsan kurulum tamam; Cursor’da MCP command değerinin sdd-mcp olduğundan emin ol.
• Araçlar görünmüyor: Cursor’u yeniden başlat veya MCP sunucularını yenile; PROJECT_ROOT için ${workspaceFolder} kullandığından emin ol.
• Spec/plan oluşmuyor: Önce /sdd_specify "..." ile spec, sonra /sdd_plan, sonra /sdd_tasks çağır; ardından /sdd_implement phase=1 ile devam et.

Geliştiriciler / Kaynaktan kurulum ve npm’e yayınlama

Paketi kaynaktan kurmak veya npm’e yayınlamak istiyorsan:

Kaynaktan global kurulum

git clone <repo-url>
cd spec2code--iOS-
npm install
npm run build:lib
npm run install:global

İzin hatası alırsan: sudo npm run install:global

npm’e yayınlama

1. https://www.npmjs.com/signup — Hesap oluştur.
2. Terminalde npm login (username, password, email).
3. package.json içinde "name": "ios-sdd-mcp" (veya @kullaniciadin/ios-sdd-mcp).
4. Proje klasöründe:

   npm run build:lib
   npm publish

   Scope kullandıysan: npm publish --access public
5. Versiyon güncellemek için package.json → "version": "1.0.1" artırıp tekrar npm publish.

iOS projelerini AI ile spec’ten koda taşı. 🎉