n2-stitch-mcp

🛡️ Stitch API 韧性代理专家

🥥54总安装量 20评分人数 22
100% 的用户推荐

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

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 纯文档型资产,无代码执行风险,SKILL.md 仅包含配置说明和示例
  • ✅ 无数据收集行为,API 密钥管理完全由用户本地控制
  • ✅ 无危险函数调用,Markdown 内嵌代码均为低风险配置模板
  • ⚠️ 实际执行代码托管于 NPM 包,建议用户额外审查 `n2-stitch-mcp` 包源码
  • ⚠️ 来源为个人开发者账号(T3),社区认可度和长期维护存在不确定性

使用说明

核心用法

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 内容

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