Stitch-MCP

Ein MCP-Server (Model Context Protocol), der die Funktionen von Google Stitch als lokale Tools bereitstellt, indem Anfragen an den Remote-Stitch-MCP-Endpunkt weitergeleitet werden.

Was dieses Tool macht

Dieser Server:

• Führt einen lokalen MCP-Tool-Server (stdio) unter Verwendung von mcp.server.fastmcp.FastMCP aus

• Leitet Tool-Aufrufe an https://stitch.googleapis.com/mcp weiter

• Erfordert einen Stitch-API-Schlüssel, der über die Umgebungsvariable STITCH_API_KEY bereitgestellt wird

Related MCP server: stitch-pro-mcp

Anforderungen

• Python 3.11+

• Ein Stitch-API-Schlüssel (STITCH_API_KEY)

Installation

Erstellen und aktivieren Sie eine virtuelle Umgebung und installieren Sie dann das Paket:

python -m venv .venv
source .venv/bin/activate
pip install -e .

Konfiguration

Der Server lädt Umgebungsvariablen aus einer lokalen .env-Datei (via python-dotenv), falls vorhanden.

Erstellen Sie eine .env-Datei:

STITCH_API_KEY=your_api_key_here

Server ausführen

Sie können ihn über das installierte Skript ausführen:

stitch-mcp

Oder direkt:

python server.py

Registrieren Sie in Ihrem MCP-Client einen stdio-Server, der stitch-mcp (oder python server.py) ausführt, und stellen Sie sicher, dass STITCH_API_KEY in dieser Prozessumgebung verfügbar ist.

Verfügbare Tools

Projektmanagement:

• list_projects(filter: Optional[str] = None)

• create_project(title: str)

• get_project(name: str)

Bildschirmverwaltung:

• list_screens(projectId: str)

• get_screen(name: str, projectId: str, screenId: str)

KI-Generierung:

• generate_screen_from_text(projectId: str, prompt: str, deviceType: str = "MOBILE", modelId: str = "GEMINI_3_FLASH")

• edit_screens(projectId: str, selectedScreenIds: list[str], prompt: str, deviceType: str = "DEVICE_TYPE_UNSPECIFIED", modelId: str = "GEMINI_3_FLASH")

• generate_variants(projectId: str, selectedScreenIds: list[str], prompt: str, variantCount: int = 3, creativeRange: str = "EXPLORE", aspects: Optional[list[str]] = None, deviceType: str = "DEVICE_TYPE_UNSPECIFIED", modelId: str = "GEMINI_3_FLASH")

Design-Systeme:

• list_design_systems(projectId: Optional[str] = None)

• create_design_system(...)

• update_design_system(...)

• apply_design_system(projectId: str, assetId: str, screen_instance_ids: list[str], screen_source_names: list[str])

Hinweise und Fehlerbehebung

• Wenn Sie die Meldung STITCH_API_KEY environment variable not set sehen, überprüfen Sie Ihre .env-Datei/Umgebung und starten Sie den MCP-Client-Prozess neu.

• Einige Generierungsvorgänge können einige Minuten dauern. Wenn eine Anfrage eine Zeitüberschreitung (Timeout) verursacht, warten Sie kurz und rufen Sie get_screen später erneut auf (der Server gibt in diesem Fall eine Timeout-Meldung zurück).

Entwicklung

agent.py ist ein kleines Hilfsskript, um die Tools manuell ohne einen MCP-Client zu testen. Aktualisieren Sie die Platzhalter-IDs und führen Sie es aus:

python agent.py

Beitrag leisten

• Wenn Sie Vorschläge zu diesem Projekt oder dem Skript haben, lassen Sie es mich gerne wissen. Wenn es Ihnen gefällt, können Sie es gerne für sich selbst verwenden. (P.S. Geben Sie ihm auch einen Stern!! 😬 )

• Ihre Beiträge sind hier sehr willkommen!

  Forken Sie das Projekt

  Kompilieren Sie Ihre Arbeit

  Erstellen Sie einen Pull Request

Credits: Samuel Jayasingh

Zuletzt bearbeitet am: 16.04.2026