Summary

This CLI tool, stitch-mcp, bridges AI-generated UI designs from Google's Stitch platform into developer workflows. It automates fetching, local serving, and structuring designs for previewing, building, or feeding into coding agents, streamlining the integration of AI-designed interfaces.

How It Works

stitch-mcp connects to Stitch via CLI commands. It serves project screens locally using a Vite server for HTML preview and generates Astro sites by mapping screens to routes, managing assets. It also acts as an MCP proxy, integrating with coding agents and exposing "virtual tools" for direct programmatic access to design HTML, screenshots, and site-building functions.

Quick Start & Requirements

Install via npx @_davideast/stitch-mcp <command> or npm install -g @_davideast/stitch-mcp. The init command guides setup, including Google Cloud SDK (gcloud) configuration, OAuth authentication, project selection, and API enablement. Prerequisites include a GCP project with billing and the Stitch API enabled.

Highlighted Details

• Local Vite dev server for screen previews.
• Astro site generation from screen-to-route mappings.
• MCP proxy for coding agent integration with token refresh.
• Virtual tools (build_site, get_screen_code, get_screen_image) for agent access.
• Interactive terminal UI for resource exploration.

Maintenance & Community

The README provides no details on contributors, sponsorships, or community channels; it is presented as an independent, experimental project by David East.

Licensing & Compatibility

Licensed under Apache 2.0, generally permitting commercial use. However, users must consider the project's experimental nature and disclaimers.

Limitations & Caveats

This is an "Experimental Project," independent and not affiliated with Google, provided "AS-IS with NO WARRANTIES." Maintenance, security, and future API compatibility are not guaranteed. Browser authentication may require manual handling in specific environments (WSL, SSH, Docker).