n2-stitch-mcp

🛡️ Stitch API 韧性代理专家

N2 Stitch MCP 是 Google Stitch 的韧性代理工具,通过 TCP 断连自动恢复、指数退避重试等三层防护机制,解决长时 UI 生成任务易中断的痛点,为开发者提供稳定可靠的屏幕生成体验。

收藏
845
安装
315
版本
v1.0.0
CLS 安全性认证2026-07-01
点击查看完整报告 >

使用说明

核心用法

N2 Stitch MCP 是一个专为 Google Stitch API 设计的 MCP(Model Context Protocol)代理服务器,主要解决 generate_screen_from_text 接口因执行时间过长(2-10 分钟)导致的 TCP 连接中断问题。用户通过 npx -y n2-stitch-mcp 快速部署后,即可在 MCP 客户端中调用 Stitch 相关工具,包括创建项目、生成屏幕、编辑设计、获取生成状态等。该技能支持两种认证方式:gcloud 命令行认证(推荐)或 API Key 环境变量配置,适配不同安全级别的使用场景。

显著优点

该技能的核心竞争力在于其三层安全防护机制:第一层是 TCP Drop Recovery,当连接在 60 秒左右被中断时,系统会自动轮询恢复而非直接失败;第二层是指数退避重试策略,配合抖动算法实现最多 3 次智能重试;第三层是后台 Token 自动刷新,避免认证过期导致的任务中断。此外,独有的 generation_statuslist_generations 虚拟工具让用户能够实时追踪长时任务的执行进度,这是其他 MCP 服务器所不具备的能力。35 项测试覆盖也体现了代码质量的可靠性。

潜在缺点与局限性

首先,该技能目前 GitHub Stars 为 0,社区认可度尚待积累,属于较新的个人项目(2026 年 2 月创建)。其次,虽然 SKILL.md 本身为纯文档无风险,但实际执行代码托管于 NPM 包中,用户需要额外审查 n2-stitch-mcp 包的源码安全性。第三,该技能强依赖 Google Stitch API 的可用性和网络连通性,在内网隔离环境或无法访问 Google 服务的地区将无法使用。最后,作为 T3 个人来源项目,缺乏官方背书,企业级安全敏感场景可能需要谨慎评估。

适合的目标群体

主要面向三类用户:一是使用 AI 工作流(如 Claude、Cursor 等 MCP 客户端)集成 Google Stitch 的开发者;二是需要批量生成或自动化管理 UI 屏幕的前端工程师和产品设计师;三是对任务稳定性有高要求、无法容忍长时生成任务因网络波动而失败的生产环境用户。特别适合那些经历过 Stitch API 频繁断连困扰、寻求更稳健替代方案的技术团队。

使用风险

性能风险:虽然代理层增加了恢复能力,但底层 Stitch API 的 2-10 分钟生成时间本身不可压缩,极端情况下总耗时可能因重试进一步延长。依赖风险:NPM 包的更新维护由个人开发者负责,长期支持存在不确定性;若 Google Stitch API 接口变更,代理层可能需要同步更新。密钥泄露风险:用户需自行管理 STITCH_API_KEY 或 gcloud 凭据,不当配置可能导致密钥泄露。网络风险:自动恢复机制依赖对外部 API 的持续轮询,在弱网环境下可能增加额外的流量消耗和延迟。

安全解读

核心功能

N2 Stitch MCP 是一款针对 Google Stitch AI 界面生成服务的 MCP(Model Context Protocol)代理增强方案,主要解决官方 API 在长耗时任务(2-10分钟)中 TCP 连接约60秒后强制断开的痛点。

显著优势

三层弹性防护架构
1. TCP 掉线自动恢复 — 通过后台轮询机制在连接中断后继续追踪生成状态

2. 指数退避重试 — 3次自动重试配合随机抖动,避免请求风暴

3. Token 自动刷新 — 后台静默刷新身份凭证,无需中断用户会话

独家功能特性

  • generation_status 实时进度查询(其他 MCP 服务端无此能力)
  • list_generations 全量生成任务追踪
  • 完整的 35 项测试套件覆盖

实际局限

| 维度 | 说明 |
|------|------|
| **功能范围** | 本 Skill 仅为**介绍文档**,实际 MCP Server 需通过 `npx n2-stitch-mcp` 另行安装执行 |
| **来源可信度** | T3 级别 — 个人开发者(choihyunsus)维护的社区项目,非企业级背书 |
| **依赖验证** | 引用的 NPM 包 `n2-stitch-mcp` 未在本次扫描范围内,需单独审计 |
| **官网可信度** | nton2.com 为独立域名,SSL 证书有效性需用户自行验证 |

适用人群

  • 使用 Claude/Gemini 等大模型调用 Google Stitch API 的开发者
  • 需生成 UI 界面且对任务完成率有严格要求的生产环境
  • 愿意接受 T3 来源项目并进行额外人工审查的技术团队

风险提醒

> 关键区分:本 Skill 文档本身安全(S+),但文档中指导安装的 npx n2-stitch-mcp 包体未经验证。建议:
> 1. 审查实际 MCP Server 源代码后再启用

> 2. 隔离运行环境,限制网络权限

> 3. 监控 STITCH_API_KEY 等凭据的使用范围

n2-stitch-mcp 内容

手动下载zip · 1.5 kB
SKILL.mdtext/markdown
请选择文件