Stitch-MCP

Un servidor MCP (Model Context Protocol) que expone las capacidades de Google Stitch como herramientas locales mediante el reenvío de solicitudes al endpoint remoto de Stitch MCP.

Qué hace esto

Este servidor:

• Ejecuta un servidor de herramientas MCP local (stdio) usando mcp.server.fastmcp.FastMCP

• Reenvía las llamadas a herramientas a https://stitch.googleapis.com/mcp

• Requiere una clave de API de Stitch proporcionada a través de la variable de entorno STITCH_API_KEY

Related MCP server: stitch-pro-mcp

Requisitos

• Python 3.11+

• Una clave de API de Stitch (STITCH_API_KEY)

Instalación

Cree y active un entorno virtual, luego instale el paquete:

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

Configuración

El servidor carga las variables de entorno desde un archivo .env local (a través de python-dotenv) si está presente.

Cree un archivo .env:

STITCH_API_KEY=your_api_key_here

Ejecutar el servidor

Puede ejecutarlo a través del script instalado:

stitch-mcp

O directamente:

python server.py

En su cliente MCP, registre un servidor stdio que ejecute stitch-mcp (o python server.py) y asegúrese de que STITCH_API_KEY esté disponible en el entorno de ese proceso.

Herramientas disponibles

Gestión de proyectos:

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

• create_project(title: str)

• get_project(name: str)

Gestión de pantallas:

• list_screens(projectId: str)

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

Generación por IA:

• 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")

Sistemas de diseño:

• 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])

Notas y solución de problemas

• Si ve STITCH_API_KEY environment variable not set, verifique su .env/entorno y reinicie el proceso del cliente MCP.

• Algunas operaciones de generación pueden tardar unos minutos. Si una solicitud agota el tiempo de espera, espere y llame a get_screen más tarde (el servidor devuelve un mensaje de tiempo de espera en este caso).

Desarrollo

agent.py es un pequeño script auxiliar para probar manualmente las herramientas sin un cliente MCP. Actualice los IDs de marcador de posición y ejecute:

python agent.py

Contribución

• Si tiene alguna sugerencia para este proyecto o sobre el script, no dude en informarme. Y si le gustó, siéntase libre de usarlo para usted mismo. (P.D. ¡¡Dale una estrella también!! 😬 )

• ¡Sus contribuciones son muy bienvenidas aquí!

  Bifurque (Fork) el proyecto

  Compile su trabajo

  Solicite un Pull Request

Créditos: Samuel Jayasingh

Última edición el: 16/04/2026