stitch-mcp 是一个命令行工具，用于衔接 Google Stitch AI 生成式 UI 设计平台与本地开发流程。
用途：把 Stitch 项目中的屏幕（screen）拉取到本地，进行预览、站点生成或交给编码智能体使用。
主要能力：在本地 Vite 开发服务器上预览项目全部屏幕；把屏幕映射为路由并生成可部署的 Astro 站点；代理 Stitch MCP 工具给编码智能体并自动刷新令牌；在终端中交互浏览设计数据；直接从命令行调用 MCP 工具。工具负责处理认证、通过 Stitch API 获取 HTML/CSS 设计并进行结构化。
使用方式：可直接用 npx 运行，如 npx @_davideast/stitch-mcp <command>，也可全局安装 npm install -g @_davideast/stitch-mcp。常用流程包括：init 初始化认证（配置 gcloud SDK、OAuth 与 MCP 客户端配置）；doctor 校验环境，加 --verbose 查看详细诊断；serve -p <project-id> 本地预览；site -p <project-id> 生成 Astro 站点，可用 --config routes.json -o ./output 非交互模式；snapshot 保存屏幕快照；proxy 启动 MCP 代理，--debug 输出日志到 /tmp/stitch-proxy-debug.log；tool 列出或调用工具，用 -s 查看 schema、-d 传入 JSON 数据。
认证支持三种方式：init 向导的自动 OAuth（凭据存于 ~/.stitch-mcp/）、设置 STITCH_API_KEY 环境变量、或使用已配置的系统 gcloud（配合 STITCH_USE_SYSTEM_GCLOUD=1）。
代理向智能体暴露的高层工具包括 build_site（按屏幕到路由的映射构建站点并返回各页 HTML）、get_screen_code（获取屏幕 HTML 代码）、get_screen_image（以 base64 下载屏幕截图）。
限制：项目自述为实验性独立项目，与 Google 或 Stitch 团队无关，需自行承担风险；使用需相应 GCP 权限与已启用计费，具体支持范围以官方说明为准；许可证为 Apache 2.0；文档未说明收费或价格信息。