Stitch-MCP

MCP-сервер (Model Context Protocol), который предоставляет возможности Google Stitch в качестве локальных инструментов путем пересылки запросов к удаленной конечной точке Stitch MCP.

Что это делает

Этот сервер:

• Запускает локальный сервер инструментов MCP (stdio) с использованием mcp.server.fastmcp.FastMCP

• Пересылает вызовы инструментов на https://stitch.googleapis.com/mcp

• Требует ключ API Stitch, предоставленный через переменную окружения STITCH_API_KEY

Related MCP server: stitch-pro-mcp

Требования

• Python 3.11+

• Ключ API Stitch (STITCH_API_KEY)

Установка

Создайте и активируйте виртуальное окружение, затем установите пакет:

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

Конфигурация

Сервер загружает переменные окружения из локального файла .env (через python-dotenv), если он существует.

Создайте файл .env:

STITCH_API_KEY=your_api_key_here

Запуск сервера

Вы можете запустить его с помощью установленного скрипта:

stitch-mcp

Или напрямую:

python server.py

В вашем MCP-клиенте зарегистрируйте stdio-сервер, который запускает stitch-mcp (или python server.py), и убедитесь, что STITCH_API_KEY доступен в окружении этого процесса.

Доступные инструменты

Управление проектами:

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

• create_project(title: str)

• get_project(name: str)

Управление экранами:

• list_screens(projectId: str)

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

Генерация с помощью ИИ:

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

Дизайн-системы:

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

Примечания и устранение неполадок

• Если вы видите сообщение STITCH_API_KEY environment variable not set, проверьте ваш файл .env/окружение и перезапустите процесс MCP-клиента.

• Некоторые операции генерации могут занимать несколько минут. Если время ожидания запроса истекло, подождите и вызовите get_screen позже (в этом случае сервер возвращает сообщение о тайм-ауте).

Разработка

agent.py — это небольшой вспомогательный скрипт для ручного тестирования инструментов без MCP-клиента. Обновите идентификаторы-заполнители и запустите:

python agent.py

Вклад

• Если у вас есть какие-либо предложения по этому проекту или скрипту, не стесняйтесь сообщить мне. И если вам понравилось, вы можете свободно использовать его для себя. (P.S. Поставьте звездочку! 😬 )

• Ваш вклад здесь очень приветствуется!

  Сделайте форк проекта

  Скомпилируйте свою работу

  Отправьте Pull Request

Авторы: Samuel Jayasingh

Последнее редактирование: 16/04/2026