Xcode MCP Server

Co dělá “Xcode” MCP Server?

Xcode MCP (Model Context Protocol) Server je specializovaný nástroj navržený pro propojení AI asistentů s vývojovým prostředím Xcode. Zpřístupněním široké škály Xcode operací přes standardizovaný protokol umožňuje AI agentům spravovat Xcode projekty, automatizovat operace se soubory, ovládat iOS simulátory a pracovat s různými závislostmi a build nástroji. Tato hluboká integrace zefektivňuje vývojové workflow a umožňuje úkoly jako buildování, testování, analýzu kódu, správu závislostí (CocoaPods a Swift Package Manager) i ovládání simulátorů provádět programově nebo pomocí inteligentních asistentů. Server je obzvlášť cenný pro automatizaci opakovaných úkolů, zlepšení kvality kódu a urychlení vývoje iOS/macOS projektů díky zpřístupnění výkonných Xcode funkcí přes přirozený jazyk nebo AI rozhraní.

Seznam promptů

V dostupných souborech repozitáře či dokumentaci nejsou zmíněny žádné šablony promptů.

Seznam zdrojů

V dostupných souborech repozitáře či dokumentaci nejsou uvedeny žádné explicitní zdroje (dle definice MCP).

Seznam nástrojů

• Nástroje pro správu projektů

  • Nastavení aktivního projektu a získání informací o projektu.
  • Vytváření nových Xcode projektů ze šablon (např. iOS, macOS).
  • Přidávání souborů do projektů s určením cíle/skupiny.
  • Parsování workspace dokumentů a výpis schémat.

• Operace se soubory

  • Čtení a zápis souborů (s podporou kódování).
  • Práce s binárními soubory přes base64.
  • Vyhledávání textu pomocí vzorů/regex.
  • Kontrola existence souborů a metadat.
  • Automatické vytváření složek.

• Build & Testování

  • Buildování projektů s vlastními volbami.
  • Spouštění testů a reportování chyb.
  • Analýza kódu.
  • Čištění build adresářů.
  • Archivace projektů pro distribuci.

• Integrace CocoaPods

  • Inicializace, instalace, aktualizace a správa pods.
  • Přidávání/odstraňování závislostí pod.
  • Spouštění libovolných pod příkazů.

• Swift Package Manager

  • Správa Swift balíčků a závislostí.
  • Aktualizace/řešení balíčků.
  • Generování dokumentace.
  • Build a test balíčků.

• Nástroje pro iOS simulátor

  • Výpis, spuštění, vypnutí simulátorů.
  • Instalace a spouštění aplikací.
  • Pořizování screenshotů/nahrávání videí.
  • Správa nastavení simulátoru.

• Xcode Utility

  • Spouštění Xcode příkazů přes xcrun.
  • Kompilace asset katalogů.
  • Generování sad ikon aplikace.
  • Trace výkonu aplikace.
  • Export/validace archivů pro App Store.
  • Přepínání mezi verzemi Xcode.

Příklady použití tohoto MCP serveru

• Automatizované nastavení projektu
  AI agenti mohou rychle vytvořit a nakonfigurovat nové Xcode projekty, nastavit správce závislostí jako CocoaPods nebo Swift Package Manager a připravit adresářovou strukturu, čímž výrazně snižují ruční práci při inicializaci projektu.

• Continuous Integration a Testování
  Automatizujte build, testovací a analytické workflow pro iOS/macOS projekty. AI rutiny mohou spouštět buildy, testy a reportovat chyby nebo problémy v kódu, což usnadňuje robustní CI/CD pipeline přímo z chatu nebo skriptu.

• Správa simulátorů a testování
  Programové ovládání iOS simulátorů pro automatizované UI testování, instalaci aplikací a pořizování screenshotů/videí zlepšuje pokrytí a spolehlivost testování mobilních aplikací.

• Správa závislostí
  Zjednodušte přidávání, odebírání a aktualizaci knihoven pomocí CocoaPods nebo Swift Package Manageru, aby projekty zůstaly aktuální a kompatibilní s minimem ručního zásahu.

• Utility pro assety a build
  Automatizujte kompilaci assetů, generování ikon a správu build artefaktů (včetně archivace a exportu pro zaslání do App Store), což zvyšuje efektivitu a snižuje riziko chyb.

Jak to nastavit

Windsurf

1. Ujistěte se, že máte nainstalovaný macOS, Xcode (14.0+), Node.js (16+) a npm.
2. Stáhněte nebo naklonujte repozitář xcode-mcp-server.
3. Spusťte instalační skript:

   chmod +x setup.sh
   ./setup.sh
   

4. Upravte konfigurační soubor Windsurf a přidejte MCP server:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. Uložte konfiguraci a restartujte Windsurf. Ověřte dostupnost nástrojů Xcode MCP.

Claude

1. Nainstalujte požadované závislosti (macOS, Xcode, Node.js, npm).
2. Naklonujte repozitář a spusťte instalační skript jako výše.
3. Najděte konfigurační soubor MCP pro Claude.
4. Přidejte Xcode MCP server:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. Uložte a restartujte Claude. Ověřte nastavení přes výpis nástrojů.

Cursor

1. Ujistěte se, že jsou nainstalovány všechny závislosti.
2. Naklonujte repozitář a spusťte instalační skript.
3. Otevřete konfigurační soubor MCP pro Cursor.
4. Přidejte následující do části mcpServers:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. Uložte a restartujte Cursor, poté ověřte, že je server aktivní.

Cline

1. Nastavte požadované závislosti a spusťte instalační skript.
2. Upravte konfigurační soubor MCP serveru Cline.
3. Vložte záznam pro Xcode MCP server:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

4. Uložte změny a restartujte Cline.
5. Ověřte, že je Xcode MCP server v Cline funkční.

Zabezpečení API klíčů pomocí proměnných prostředí

• Citlivá data (API klíče, tokeny) umístěte do souboru .env.
• Příklad použití .env:

  XCODE_MCP_API_KEY=your_api_key_here
  

• Odkazujte proměnné prostředí ve své konfiguraci:

  {
    "mcpServers": {
      "xcode-mcp": {
        "command": "npx",
        "args": ["@xcode/mcp-server@latest"],
        "env": {
          "XCODE_MCP_API_KEY": "${XCODE_MCP_API_KEY}"
        },
        "inputs": {
          "projectBaseDir": "/Users/yourname/Projects"
        }
      }
    }
  }
  

Jak používat tento MCP ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do vašeho FlowHunt workflow nejprve přidejte MCP komponentu do vašeho flow a propojte ji s AI agentem:

Kliknutím na MCP komponentu otevřete panel konfigurace. Do sekce systémové MCP konfigurace vložte informace o vašem MCP serveru v tomto JSON formátu:

{
  "xcode-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po konfiguraci může AI agent tento MCP využívat jako nástroj se všemi jeho funkcemi a schopnostmi. Nezapomeňte změnit “MCP-name” na skutečný název vašeho MCP serveru (např. “xcode-mcp”) a nahradit URL vlastní adresou MCP serveru.

Přehled

Na základě výše uvedených informací je Xcode MCP Server velmi funkční pro automatizaci Xcode, ale chybí dokumentace k šablonám promptů, explicitní podpora MCP zdrojů a sampling/roots funkcí. Silnou stránkou jsou nástroje pro projekty/build a jasný návod k nastavení.

MCP skóre

Celkově bych tento MCP server ohodnotil 7 z 10.
Poskytuje komplexní integraci a automatizaci Xcode, má dobrou dokumentaci k nastavení a jasnou licenci. Postrádá však informace o šablonách promptů, explicitních MCP zdrojích, podpoře roots a sampling, což je důležité pro plnou MCP kompatibilitu a pokročilé workflow.