
Skybridge 架构深度解析彻底搞懂 MCP App 中用户、AI 模型与应用之间的三方数据流【免费下载链接】skybridgeSkybridge is a full-stack TypeScript framework for MCP Apps and ChatGPT Apps. Type-safe. React-powered. Platform-agnostic.项目地址: https://gitcode.com/gh_mirrors/skybr/skybridgeSkybridge 是一个用于构建 MCP AppChatGPT Apps的全栈 TypeScript 框架React 驱动、端到端类型安全、平台无关。与传统 Web 应用不同MCP App 是一个三方系统数据在「用户 ↔ AI 模型 ↔ 应用工具与视图」之间流动。本文将从新手视角拆解这套三方数据流的完整架构帮你彻底搞懂每一轮对话背后发生了什么。一、先认识三位主角Host、MCP Server、View在深入数据流之前先对齐几个核心概念完整术语表见 docs/get-started/architecture.mdx角色是什么类比Host宿主内嵌模型并运行你应用的 AI 客户端如 ChatGPT、Claude舞台MCP Server你构建的服务端向模型和视图暴露一组工具Tool后台系统View视图与工具绑定的 React 组件渲染在对话流里前台界面Runtime运行时宿主内部连接服务端响应、模型与视图的桥梁调度员MCP App 的核心矛盾是上下文不对称模型是「盲」的——它看不见 UI除非你显式把信息同步回去用户看不见在底下流动的工具输出应用只能拿到模型和用户各自暴露给它的部分。所以架构设计的重点不是布局或样式而是回答谁在什么时候看到什么二、应用生命周期挂载 → 运行 → 拆除MCP App 的生命周期分为三个阶段每个阶段的「驱动者」和「数据流向」都不一样。1. 挂载阶段模型发起工具调用视图登场用户向模型提问 → 模型调用你服务器上的工具 → 服务器响应中包含两部分视图引用宿主据此把 React 视图内联挂载进对话输出内容文本、结构化数据或媒体会同时喂给模型和视图。注意每次模型调用该工具都会挂载一个全新的视图实例。2. 运行阶段状态成为共享的「事实来源」视图挂载后用户可以直接操作它触发工具调用、修改视图状态View State。关键点有两个状态同时被视图和模型看到模型因此始终知道屏幕上发生了什么只有视图能修改状态且每个视图实例拥有自己独立的状态。这套机制由 useViewState 提供——它是useState的「升级替身」状态不仅能在宿主重新挂载时存活还会在下一轮对话时暴露给模型。3. 拆除阶段对话关闭状态留底对话关闭时所有视图实例卸载下次重新打开对话视图会带着恢复的状态重新挂载。用户上次加购的商品、上次选的排序方式都不会丢。三、工具返回值把数据「寄给」正确的收件人这是新手最容易忽略的设计点工具返回的每个字段都可以分别指定给模型或视图。以 register-tool 的返回值为例返回字段谁能看到用途content模型 对话界面给模型阅读的文本structuredContent模型 视图类型安全的结构化数据_meta仅视图对模型隐藏的元信息也就是说「给模型看什么、给用户看什么、哪些字段保密」是你的设计决策直接决定了每个角色掌握的上下文。而 />用户说「我想要冬装」→ 模型调用search-products(winter)服务器返回商品目录 → 轮播视图挂载结果同时进入模型上下文用户在视图里把一件外套加入购物车 → 购物车写入视图状态用户再问「还有什么推荐」→ 模型读取购物车状态回答「轮播里那双靴子会很搭」用户点击结算按钮 → 视图直接调用create-checkout工具拿到结账链接。看出门道了吗让模型变成「私人购物顾问」的魔法正是状态共享模型读得到购物车和屏幕上的商品于是能在对话里给出指向具体商品的建议。这正是三方数据流设计价值的集中体现。五、如何快速上手验证这套架构理解完原理最快的验证方式是跑起来本地开发Skybridge 自带开发服务器内置模拟器、热模块替换HMR和一条常驻隧道可以把本地应用直接接入 ChatGPT / Claude 调试脚手架npm create skybridgelatest my-app一键初始化项目示例库仓库 examples/ 目录下提供电商、旅行、游戏、仪表盘等十余个开箱即用的 MCP App 模板每个都完整演示了工具、视图与状态之间的数据流。结语抓住「谁看到什么」就抓住了 MCP App 架构的精髓一句话总结这套三方数据流模型驱动挂载用户驱动交互状态负责同步。模型是入口调用工具用户是动力源操作视图而 View State 是贯穿两者的共享记忆。想进一步深入学习建议精读 docs/get-started/architecture.mdx 中的完整生命周期与数据流章节它是 Skybridge 架构思想的权威出处。【免费下载链接】skybridgeSkybridge is a full-stack TypeScript framework for MCP Apps and ChatGPT Apps. Type-safe. React-powered. Platform-agnostic.项目地址: https://gitcode.com/gh_mirrors/skybr/skybridge创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考