
用 Skybridge 打造电商 MCP App 实战带购物车的产品轮播与本地化体验【免费下载链接】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 是一个全栈 TypeScript 框架专为构建 MCP Apps 和 ChatGPT Apps 而生类型安全、React 驱动、平台无关。今天用它内置的电商示例带你完整跑通一个电商 MCP App——在 AI 对话里搜索商品、渲染产品轮播、点开全屏详情页选颜色尺码价格还能跟随用户语言自动本地化。无需任何宿主支持几分钟就能在本地看到效果。先看效果对话里的产品轮播与详情页 用户对模型说给我看看滑雪板模型会先在商品目录里搜索、挑选然后把精选商品以轮播形式渲染在对话中点击任意卡片切换到全屏商品详情——图片画廊、颜色/尺码选择器、规格参数一应俱全底部 CTA 直达店铺完成下单。这就是先推理、再呈现的典型电商交互整套体验由 Skybridge 的 View 机制驱动工具返回的完整商品数据通过_meta传给 React 视图模型只拿到精简后的背景数据用于回答追问两者互不干扰。三步本地跑起电商 MCP App示例位于 examples/ecom-carousel/完整说明见 examples/ecom-carousel/README.md。第 1 步获取代码git clone https://gitcode.com/gh_mirrors/skybr/skybridge cd skybridge/examples/ecom-carousel第 2 步安装依赖需要 Node.js 24npm install第 3 步启动开发服务器npm run dev启动后你会得到两个入口MCP 服务http://localhost:3000/mcpSkybridge DevToolshttp://localhost:3000/在 DevTools 里可以直接调用工具、切换显示模式、模拟不同宿主宽度与语言无需任何外部客户端即可调试整个 App如果想换成自己的商品数据只需复制.env.template为.env填入MEDUSA_BASE_URL与MEDUSA_PUBLISHABLE_KEY想换掉后端只需改写 src/lib/medusa.ts 一个文件——数据源完全可插拔。双工具模式先搜索后渲染 这是该示例最核心的架构代码集中在 src/server.tsserver .registerTool(searchProductsDefinition, searchProductsHandler) .registerTool(renderCarouselDefinition, renderCarouselHandler)search-products无界面接收关键词、分类、排序只返回给模型的结构化数据标题、价格、评分、规格用户看不到原始结果。定义见 src/tools/search-products.ts。render-carousel有界面接收模型精选的商品 ID把完整商品数据图片、变体、媒体放进_meta交给轮播视图渲染。定义见 src/tools/render-carousel.ts。服务器级的instructions还会约束模型的行为节奏搜索阶段保持静默、反复迭代至少两次搜索、变换关键词轮播渲染之后才开口推荐且推荐顺序与轮播一致。这种数据与渲染分离让模型先把智能用在挑选上用户看到的永远是精挑细过的结果本地化体验价格跟着用户语言走 同一个 App不同语言的用户看到的是符合自己习惯的价格与文案取语言视图通过useUser()拿到宿主传入的locale如en-US取语言子标签en未收录的语言自动回退英文见 src/i18n.ts。格式化价格基于Intl.NumberFormat按用户语言渲染货币如€1,299.00与1.299,00 €见 src/lib/format.ts。文案标签集中管理缺货提示、上一页/下一页、规格标题等全部走LABELS表新增语言只需加一个 key。详情页的 View on site 按钮通过useOpenExternal跳转到店铺下单页CSP 配置同时放行了商品图片域名与跳转域名见 render-carousel.ts保证在严格安全策略的宿主中也能正常显示图片、跳转结算。从本地到线上验证与部署 本地开发之外Skybridge 提供了一条快速验证链路npm run dev -- --tunnel加上--tunnel参数后会打印一个公网地址在/try路径打开 Playground——用真实模型在真实宿主里跑一遍你的 App截图效果与线上几乎一致验证通过后即可部署Skybridge 不绑定任何云厂商任何支持 MCP 的平台都能托管详见 docs/ship/deploy.mdx。部署完成后把远程 App 的 MCP 地址配置到 ChatGPT、Claude 等客户端电商体验即刻上线总结这个电商 MCP App 示例展示了 Skybridge 的几个关键能力双工具分离让模型先思考后呈现、_meta通道让视图拿到完整数据而模型保持精简、useUser()本地化让价格与文案随用户语言切换、可插拔数据源让你只改一个文件就能接入自己的商品库。想从零开始自己的版本一条命令即可npx skybridge create my-shop --ecom电商模板与构建指南见 docs/guides/ecommerce.mdx官方文档目录见 docs/。从克隆代码到对话里滚轮播不到五分钟——这就是用 Skybridge 做电商 MCP App 的完整路径。【免费下载链接】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),仅供参考