@mmerterden/multi-agent-toolkit-mcp 3.0.0

package/README.tr.md

@@ -0,0 +1,358 @@
+# @mmerterden/multi-agent-toolkit-mcp
+
+[![npm version](https://img.shields.io/npm/v/@mmerterden/multi-agent-toolkit-mcp)](https://www.npmjs.com/package/@mmerterden/multi-agent-toolkit-mcp)
+[![npm downloads](https://img.shields.io/npm/dw/@mmerterden/multi-agent-toolkit-mcp)](https://www.npmjs.com/package/@mmerterden/multi-agent-toolkit-mcp)
+[![GitHub stars](https://img.shields.io/github/stars/mmerterden/multi-agent-toolkit-mcp)](https://github.com/mmerterden/multi-agent-toolkit-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+🇬🇧 English: [README.md](./README.md)
+
+iOS Simulator, Android Emulator ve headless web kontrolü için **83 araç**. AI kodlama asistanının mobil uygulamalarını görmesini, onlarla etkileşime girmesini ve denetlemesini sağlayan bir MCP sunucusu - ayrıca tarayıcıları sürer, 18-kurallık bir App Store uyumluluk denetimi çalıştırır ve çok-adımlı batch akışlarını orkestre eder.
+
+**Public npm registry** üzerinden dağıtılır - `npx @mmerterden/multi-agent-toolkit-mcp`, auth'suz, token'sız, `~/.npmrc` ayarı gerekmeden çözülür.
+
+**Claude Code, Copilot CLI ve Codex CLI üzerinde doğrulanmıştır** - release kapılarının fiilen çalıştırdığı üç host. Standart bir stdio MCP sunucusu olduğu için Cursor, Antigravity, VS Code Copilot Chat, Claude Desktop ve diğer herhangi bir MCP client'ında da çalışır; bunlar için config parçacıkları aşağıda, ama burada hiçbir şey onları kontrol etmiyor.
+
+Bu ayrımı net tutmakta fayda var. Bu satır bir zamanlar beş host'u "multi-agent-pipeline'ın tam-orkestrasyon hedefleri" olarak adlandırıyordu, bu da pipeline v10.7.0'da Cursor / Antigravity / Codex / Copilot Chat adaptörleri silindiğinde doğru olmaktan çıktı. Codex CLI, pipeline v13.0.0'da yetenek üzerinden birinci-sınıf bir hedef olarak geri döndü - artık skill'leri, paralel sub-agent'ları, hook'ları ve MCP'si var - ve doğrulanmış listede sadece bir kapı onu çalıştırdığı için yer alıyor, başka bir yerde desteklendiği için değil. Kimsenin çalıştırmadığı host'ları iddia etmek de bedavaya gelmiyor: 2.20.0 ve 2.21.0, ilk araçta yasa dışı bir `outputSchema` gönderdi, bu yüzden Claude Code tüm `tools/list`'i reddetti ve 78'in sıfırını sundu - birincil host'ta, iki release boyunca, bu repo'daki her kapı yeşilken.
+
+**7 kategori:**
+- **Device Control** (59 araç) - screenshot, tap, swipe, type, navigate, dark mode, locale, orientation, location, permissions, push notifications, gerçek start/stop ekran kaydı
+- **Crash Diagnostics** (2 araç) - `ios_list_crashes` host'un DiagnosticReports dizinini okur, `android_list_crashes` adb crash buffer'ını döker, ikisi de tail-sınırlı
+- **Accessibility Audit** (2 araç) - eksik label'ları, küçük tap target'larını, eksik identifier'ları otomatik tespit et (scope filtreleme desteklenir)
+- **Store Compliance** (5 araç) - App Store / Play Store hazırlığı; **18-kurallık derin `ios_app_store_audit`**, Apple ITMS hata kodları + App Store Review Guidelines'a çapraz referans verir (privacy manifest, required-reason API, Info.plist, code signing, entitlements, gömülü SDK, IPv6, debug-tool sızıntısı, ...)
+- **Web Automation** (8 araç) - Playwright-destekli: goto, click (CSS selector'lar), type, JS eval, selector bekleme, metin çıkarma, screenshot. Chromium / WebKit / Firefox motorları. **`playwright` peer dependency'si gerektirir.**
+- **Design Audit** (6 araç) - mock-mode vs Figma uygunluğu: scenario envanteri, mock tespiti, mock launch, canlı UI geometrisi, piksel/geometri/tipografi karşılaştırması, ve coverage kapısıyla birlikte HTML/PDF rapor
+- **Autonomous Agent DSL** (1 araç) - `agent_run_steps`, tek bir MCP round trip'inde {tool, args, continue_on_error?, wait_ms?} adımlarından oluşan bir batch dizisini çalıştırır. Scriptlenmiş login akışları, form doldurma, çok-adımlı QA yolları için ideal.
+
+## Hızlı Başlangıç
+
+### Seçenek A - Kaynaktan kur (önerilen, auth gerekmez)
+
+En basit yol. `~/.npmrc`'yi henüz yapılandırmasan bile çalışır.
+
+```bash
+git clone git@github.com:mmerterden/multi-agent-toolkit-mcp.git
+cd multi-agent-toolkit-mcp
+npm install
+
+# Opsiyonel: web araçları Playwright gerektirir
+npm i -g playwright && npx playwright install chromium
+
+# 'multi-agent-toolkit-mcp' olarak global kullanılabilir yap
+npm link
+```
+
+Sonra klonun içinde `git pull && npm install` ile güncelle. İlgili tag'i checkout ederek belirli bir versiyona pinle (`git tag -l` ile listele).
+
+### Seçenek B - npx (kurulum gerekmez - public registry)
+
+```bash
+npx @mmerterden/multi-agent-toolkit-mcp
+```
+
+### Kurulum (Seçenek A veya B'den sonra)
+
+#### Claude Code / Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "multi-agent-toolkit": {
+      "command": "npx",
+      "args": ["-y", "@mmerterden/multi-agent-toolkit-mcp"]
+    }
+  }
+}
+```
+
+#### Cursor
+
+`.cursor/mcp.json`'a ekle:
+```json
+{
+  "mcpServers": {
+    "multi-agent-toolkit": {
+      "command": "npx",
+      "args": ["-y", "@mmerterden/multi-agent-toolkit-mcp"]
+    }
+  }
+}
+```
+
+#### Antigravity
+
+`.agent/mcp_config.json`'a (ya da global `~/.gemini/antigravity/mcp_config.json`'a) ekle:
+```json
+{
+  "mcpServers": {
+    "multi-agent-toolkit": {
+      "command": "npx",
+      "args": ["-y", "@mmerterden/multi-agent-toolkit-mcp"]
+    }
+  }
+}
+```
+
+#### Copilot CLI
+
+`~/.copilot/settings.json`'a ekle:
+```json
+{
+  "mcpServers": {
+    "multi-agent-toolkit": {
+      "command": "npx",
+      "args": ["-y", "@mmerterden/multi-agent-toolkit-mcp"]
+    }
+  }
+}
+```
+
+#### Codex CLI
+
+Kendi config'ini Codex'in yazmasına izin ver - `~/.codex/config.toml`'u o
+sahiplenir (marketplace ve plugin durumu da orada yaşar), ve komut idempotent'tir:
+
+```bash
+codex mcp add multi-agent-toolkit -- npx -y @mmerterden/multi-agent-toolkit-mcp
+codex mcp list                 # doğrula
+codex doctor --json            # checks["mcp.config"] "ok" okumalı
+```
+
+Referans olarak, bu şunu üretir:
+```toml
+[mcp_servers.multi-agent-toolkit]
+command = "npx"
+args = ["-y", "@mmerterden/multi-agent-toolkit-mcp"]
+```
+
+Multi-agent pipeline'ın `install --codex`'i `codex mcp add` adımını senin için çalıştırır.
+
+## Sorun Giderme
+
+### `npx @mmerterden/multi-agent-toolkit-mcp` 401/404 veriyor, ya da eski bir versiyonu çözüyor
+
+Bu paket **public** npm registry'de - token gerekmez. Hâlâ başarısız oluyorsa,
+en olası sebep bu paketin GitHub Packages'tan taşınmadan önceki bir kalıntı
+scope override'ı: `~/.npmrc`'de `@mmerterden:registry=https://npm.pkg.github.com`
+gibi bir satır olup olmadığına bak. O satır **her** `@mmerterden`-scope'lu
+install/publish'i (bu paket dahil) GitHub Packages'a yönlendirir, ki o da
+public görünümlü bir paket adı için bile auth'suz bir okumaya 401 döner. O
+satırı kaldır (ya da gerçekten GitHub Packages'a ihtiyacı olan `@mmerterden`
+paketine scope'la) ve tekrar dene.
+
+#### VS Code Copilot Chat
+
+`.vscode/mcp.json`'a ekle:
+```json
+{
+  "servers": {
+    "multi-agent-toolkit": {
+      "command": "npx",
+      "args": ["-y", "@mmerterden/multi-agent-toolkit-mcp"]
+    }
+  }
+}
+```
+
+### Gereksinimler
+
+- **Node.js 18+**
+- **iOS araçları**: macOS + Xcode (`xcrun simctl`'i sağlar)
+- **Android araçları**: Android SDK Platform-Tools (`adb`'yi sağlar)
+- **Web araçları** (opsiyonel): `playwright` - bir kere kur:
+  ```bash
+  npm i -g playwright && npx playwright install chromium
+  ```
+  (ya da `webkit` / `firefox` - motoru her `web_goto` çağrısında seç.)
+
+> Xcode kurulu değilse, iOS araçları crash etmek yerine anlaşılır bir mesaj döner. Android ve Web araçları için de aynı - elindekini kullan.
+
+### Agent DSL Örneği
+
+Tek bir MCP çağrısında scriptlenmiş bir login akışı çalıştır:
+
+```json
+{
+  "tool": "agent_run_steps",
+  "args": {
+    "steps": [
+      { "tool": "web_goto", "args": { "url": "https://example.com/login" } },
+      { "tool": "web_type", "args": { "selector": "#email", "text": "user@example.com" } },
+      { "tool": "web_type", "args": { "selector": "#password", "text": "s3cret" } },
+      { "tool": "web_click", "args": { "selector": "button[type=submit]" }, "wait_ms": 1000 },
+      { "tool": "web_wait_for", "args": { "selector": ".dashboard" } },
+      { "tool": "web_screenshot", "args": { "full_page": true } }
+    ]
+  }
+}
+```
+
+Agent'ın hata durumunda kendini düzeltebilmesi için adım-başına durum döner.
+
+### iOS Araçları (38)
+
+| Araç | Açıklama |
+|------|-------------|
+| `ios_list_devices` | Mevcut tüm simulator'ları listele |
+| `ios_boot_device` | Bir simulator'ı boot et |
+| `ios_screenshot` | Screenshot yakala (base64 PNG) |
+| `ios_tap` | Koordinatlara tap yap |
+| `ios_swipe` | Swipe hareketi |
+| `ios_type_text` | Odaklanmış alana metin yaz |
+| `ios_launch_app` | Bundle ID ile uygulama başlat |
+| `ios_terminate_app` | Uygulamayı sonlandır |
+| `ios_list_apps` | Kurulu uygulamaları listele |
+| `ios_go_home` | Home tuşuna bas |
+| `ios_set_appearance` | Açık/koyu modu ayarla |
+| `ios_set_content_size` | Dynamic Type boyutunu ayarla |
+| `ios_set_locale` | Uygulama dilini değiştir |
+| `ios_open_url` | URL veya deep link aç |
+| `ios_status_bar` | Status bar'ı override et - preset'leri destekler (App Store screenshot'ları için `clean` 9:41/%100, `testing`, `low-battery`, `airplane`) artı manuel zaman/pil |
+| `ios_push_notification` | Simüle edilmiş push gönder |
+| `ios_grant_permission` | Gizlilik izni ver |
+| `ios_revoke_permission` | İzni geri al |
+| `ios_reset_permissions` | Tüm izinleri sıfırla |
+| `ios_set_location` | Simüle edilmiş GPS ayarla |
+| `ios_clear_location` | Konumu temizle |
+| `ios_set_increase_contrast` | Increase Contrast'ı aç/kapat |
+| `ios_record_video` | Ekran kaydı - action:"start" arka planda kaydeder, action:"stop" video dosyasını döner |
+| `ios_add_media` | Fotoğraf kütüphanesine ekle |
+| `ios_keychain_reset` | Keychain'i sıfırla |
+| `ios_get_app_container` | Uygulama dosya yolunu al |
+| `ios_erase_device` | Simulator'ı fabrika ayarlarına döndür |
+| `ios_get_ui_tree` | Accessibility UI ağacı |
+| `ios_accessibility_audit` | Otomatik denetim: eksik label'lar, küçük tap target'ları, eksik identifier'lar |
+| `ios_biometric` | Face ID / Touch ID'yi simüle et (eşleşme veya başarısızlık) |
+| `ios_archive_audit` | .xcarchive'ı App Store uyumluluğu için denetle (daha hafif, deprecated - `ios_app_store_audit`'i kullan) |
+| `ios_app_store_audit` | .xcarchive üzerinde derin 18-kurallık App Store uyumluluk denetimi - privacy manifest, required-reason API, Info.plist, code signing, entitlements, gömülü SDK, IPv6, debug-tool sızıntısı, binary boyutu, ölü referanslar, duplicate kaynaklar, team ID, provisioning profile, Swift ABI, extension signing, asset doğrulama, production hijyeni, SDK tabanı (ITMS-90725) kapsar. Apple ITMS hata kodları + App Store Review Guidelines'a çapraz referans verir |
+| `ios_export_ipa` | `xcodebuild -exportArchive` üzerinden bir .xcarchive'ı imzalı bir .ipa'ya export et. exportOptions.plist'i argümanlardan üretir (method varsayılan olarak `app-store-connect`). 0 ile çıkıp .ipa üretmeyen bir çalıştırma başarısızlık olarak raporlanır |
+| `ios_testflight_validate` | Apple'ın kendi pre-submission doğrulaması, `xcrun altool --validate-app` üzerinden, dönen ITMS kodları ima ettikleri App Store kuralına eşlenmiş halde. Statik analizin yapısal olarak yakalayamayacağını yakalar: kayıtsız bundle ID, profile/app-record uyuşmazlığı, zaten kullanılmış bir version+build, App ID için provision edilmemiş entitlement'lar. 3-katmanlı auth (ASC API key → Apple ID + app-specific şifre keychain/env referansıyla → gerekçesiyle `SKIPPED`). **`SKIPPED` bir pass değildir** |
+| `ios_xcodebuild` | Bir Xcode projesini build / test / clean / archive et. Tek satırlık özet + xcresult ID döner; tam log context dışında kalır |
+| `ios_xcresult` | ID ile önceki bir build'e derinlemesine gir - modlar: `summary`, `errors`, `warnings`, `log`, `tests`. Token-verimli kademeli açığa çıkarma |
+| `ios_visual_diff` | İki PNG screenshot'ı karşılaştır (pixelmatch). diff_pct, threshold'a karşı pass/fail, opsiyonel diff PNG döner. Açık/koyu mod, locale, dynamic type genelinde snapshot regresyonları için kullanışlı |
+| `ios_list_crashes` | Host'un DiagnosticReports dizinindeki güncel crash raporlarını listele - süreç adına göre filtrele, yaş ve sayı ile sınırla |
+
+### Android Araçları (30)
+
+| Araç | Açıklama |
+|------|-------------|
+| `android_list_devices` | Bağlı cihazları listele |
+| `android_screenshot` | Screenshot yakala (base64 PNG) |
+| `android_tap` | Koordinatlara tap yap |
+| `android_swipe` | Swipe hareketi |
+| `android_type_text` | Metin yaz |
+| `android_key_event` | Tuş olayı gönder (HOME, BACK, ENTER) |
+| `android_launch_app` | Package ile uygulama başlat |
+| `android_stop_app` | Uygulamayı zorla durdur |
+| `android_list_packages` | Kurulu package'ları listele |
+| `android_go_home` | Home'a bas |
+| `android_go_back` | Back'e bas |
+| `android_get_ui_tree` | UI hiyerarşisi (uiautomator XML) - `path` ham dökümü dosyaya yazar, filter:"interactive" kompakt aksiyon-elemanı listesi döner |
+| `android_set_dark_mode` | Koyu modu aç/kapat |
+| `android_set_font_scale` | Font ölçeğini ayarla |
+| `android_set_locale` | Locale'i değiştir |
+| `android_set_location` | Sahte GPS konumu |
+| `android_grant_permission` | Runtime izni ver |
+| `android_revoke_permission` | İzni geri al |
+| `android_record_screen` | Ekran kaydı - action:"start" arka planda kaydeder, action:"stop" videoyu cihazdan çeker |
+| `android_install_apk` | APK kur |
+| `android_uninstall_app` | Uygulamayı kaldır |
+| `android_logcat` | Logları görüntüle |
+| `android_get_screen_size` | Ekran çözünürlüğünü al |
+| `android_open_url` | URL veya deep link aç |
+| `android_clear_app_data` | Uygulama verisini temizle |
+| `android_accessibility_audit` | Otomatik denetim: eksik contentDescription, küçük touch target'lar, eksik resource-id |
+| `android_launch_time` | Soğuk başlangıç süresini ölç (ms) |
+| `android_apk_audit` | APK'yı Play Store uyumluluğu için denetle |
+| `android_list_crashes` | adb crash log buffer'ını dök, tail-sınırlı |
+| `android_set_orientation` | Portrait/landscape'e döndür (user_rotation'ı sabitler, auto-rotate'i kapatır) |
+
+### Design Araçları (6)
+
+Mock-mode vs Figma tasarım denetimi. Jenerik ve platform-bağımsız - ağır orkestrasyonun (Figma çekme, varyant eşleme, ekran navigasyonu, rapor derleme) çağıranda yaşaması beklenir; bunlar mekanik ilkel işlemleri açığa çıkarır.
+
+| Araç | Açıklama |
+|------|-------------|
+| `design_mock_detect` | Bir projenin mock/stub modunu desteklediğini (`true` / `false` / `debug-only`) isimlendirme konvansiyonları, `#if DEBUG` DI, MockData fixture'ları ve bilinen runtime switch key'leri (genişletilebilir) üzerinden tespit et. Aktivasyon + varyant ipuçları + kanıt döner. |
+| `design_scenario_inventory` | Mock build'in açığa çıkardığı her state sürücüsünü enumerate et - relaunch flag'leri, `*Scenario` / `*Outcome` enum case'leri, reference-prefix varyantları (ekran-başına mock repository'ler içindeki `hasPrefix("F6DI")` dalları, genelde en büyük grup), akış-geneli senaryo kodları, MockData fixture'ları, custom-scheme deep link'ler - her biri dosya+satır kanıtıyla. Her hedefi (`relaunch` vs `in-app`) fiyatlandırır ve bir çalıştırma `plan`ına gruplar, böylece bir relaunch o ekrandaki her in-app state'e hizmet eder. Bir denetime "UI'da bitmiş hissedene kadar gez" yerine sayılabilir bir hedef seti verir. |
+| `design_mock_launch` | Kurulu bir uygulamayı mock modda başlat (iOS UserDefaults launch arg / Android intent extra). |
+| `design_ui_geometry` | Piksel-seviyesi boşluk ölçümü için mevcut ekranın düz element bounding box'ları + ekran boyutu. |
+| `design_visual_compare` | Bir Figma render'ını canlı bir screenshot ile boyut uyuşmazlığında başarısız olmadan karşılaştır: ölçeği normalize eder, chrome'u kırpar, algısal diff %'sini, boşluk/boyut/pozisyonu (px), rengi (ΔE) ve tipografiyi raporlar. figma/live/diff/overlay/side-by-side PNG'leri yazar. |
+| `design_report` | Bir tasarım-denetim rapor nesnesini kendi kendine yeten HTML'e (base64 görseller, CSS-konumlandırılmış annotasyonlar) + opsiyonel PDF'e render et. Bir coverage kapısı zorlar: her hedef denetlenmeli ya da açık bir gerekçeyle atlanmalı, böylece kısmi bir denetim temiz bir rapor olarak render edilemez. Metin bir label pack'ten gelir (varsayılan İngilizce, Türkçe dahili olarak yerleşik). |
+
+### Kullanım Senaryoları
+
+- **Görsel bug avcılığı** - Her ekranın screenshot'ını al, AI layout sorunları için analiz etsin
+- **Dark mode testi** - Görünümü değiştir, screenshot al, karşılaştır
+- **Accessibility denetimi** - Eksik label'ları, küçük tap target'ları otomatik tespit et (<44pt iOS / <48dp Android)
+- **Store uyumluluğu** - Submission öncesi .xcarchive veya .apk'yı denetle (signing, debug araçları, privacy manifest)
+- **Biyometrik test** - Face ID / Touch ID başarı ve başarısızlık akışlarını simüle et
+- **Performans** - Android soğuk başlangıç süresini ölç (ms)
+- **Lokalizasyon testi** - Locale'i değiştir, tüm ekranların screenshot'ını al
+- **App Store screenshot'ları** - Temiz status bar + otomatik navigasyon
+- **Regresyon testi** - Akışlarda tap'le gez, davranışı doğrula
+
+### Nasıl Çalışır
+
+```mermaid
+graph LR
+    subgraph "Sen"
+        PROMPT["Prompt"]
+    end
+
+    subgraph "AI Asistanı"
+        AI["Claude Code / Copilot CLI (doğrulanmış)\ndiğer herhangi bir MCP client"]
+    end
+
+    subgraph "multi-agent-toolkit-mcp"
+        MCP["MCP Sunucusu"]
+        IOS["iOS Araçları (37)\nxcrun simctl"]
+        AND["Android Araçları (28)\nadb"]
+        WEB["Web Araçları (8)\nPlaywright"]
+        DSL["Agent DSL (1)\nBatch runner"]
+    end
+
+    subgraph "Cihazlar"
+        SIM["📱 iOS Simulator"]
+        EMU["🤖 Android Emulator"]
+        BROWSER["🌐 Tarayıcı"]
+    end
+
+    PROMPT --> AI
+    AI -- "MCP Protokolü" --> MCP
+    MCP --> IOS --> SIM
+    MCP --> AND --> EMU
+    MCP --> WEB --> BROWSER
+    MCP --> DSL
+    SIM -- "screenshot / UI ağacı" --> AI
+    EMU -- "screenshot / UI ağacı" --> AI
+    BROWSER -- "screenshot / metin" --> AI
+
+    style MCP fill:#8b5cf6,color:#fff
+    style IOS fill:#3b82f6,color:#fff
+    style AND fill:#10b981,color:#fff
+    style WEB fill:#f59e0b,color:#fff
+```
+
+1. AI asistanın bir cihazla etkileşime girmesi gerektiğine karar verir
+2. MCP protokolü üzerinden `ios_screenshot` veya `android_tap` gibi bir araç çağırır
+3. Bu sunucu çağrıyı alır ve native komutu çalıştırır (`xcrun simctl` veya `adb`)
+4. Sonuç (screenshot, UI ağacı, aksiyon onayı) AI'a döner
+5. AI sonucu analiz eder ve sonraki aksiyona karar verir
+
+**Ne'yi sarmalıyor:**
+- **iOS**: `xcrun simctl` (Xcode Command Line Tools'un bir parçası)
+- **Android**: `adb` (Android SDK Platform-Tools'un bir parçası)
+- **Web**: Playwright (Chromium / WebKit / Firefox)
+
+**Ne YAPMIYOR:**
+- Kaynak koduna erişmiyor
+- Herhangi bir sunucuya veri göndermiyor
+- Bir hesap veya API key gerektirmiyor
+- Proje dosyalarını değiştirmiyor
+
+Her şey lokalde, kendi makinende çalışır.
+
+## Lisans
+
+MIT