GitHub - alpic-ai/skybridge: Skybridge 是一个用于 MCP 应用和 ChatGPT 应用的全栈 TypeScript 框架。

Skybridge - MCP 应用框架

面向 MCP 应用与 MCP 服务器的全栈 React 框架。

文档 · 快速入门 · 示例

关于 Skybridge

Skybridge 帮助开发者为 Claude、ChatGPT 及其他支持 UI 的 MCP 客户端构建类型安全的 MCP 应用,提供一套专为人类和 Agent 设计的完整工具链。

为什么需要它?MCP 应用在 Model Context Protocol 的基础上扩展了由 MCP 服务器渲染的丰富交互式 UI 视图。对话式应用需要用户、UI 与模型之间的无缝协作,这意味着需要全新的 UX 模式、开发者工具和抽象层。此外,原始 SDK 层级较低:没有 hooks、类型安全、HMR 等特性。

这正是我们构建 Skybridge 的原因。

功能亮点:

  • 愉悦的开发环境:Skybridge 提供内置本地模拟器的开发服务器、热模块重载,以及将本地应用连接到 Claude 和 ChatGPT 的永久隧道。

  • 一次编写,随处运行:框架抹平了不同 MCP 客户端之间的实现差异,让你的应用在 Claude、ChatGPT、VSCode 及任何兼容 MCP 应用的客户端中无缝运行。

  • Agent 就绪:强大的技能(skills)、CLI 及可编程的开发工具 API,为你的编码 Agent 提供端到端构建 MCP 应用所需的一切。

  • 端到端类型安全:类似 tRPC 的类型推断,从 MCP 服务器工具定义直通 React 视图,实现服务端到前端的全链路类型安全。

  • React 优先:直观的 React Query 风格 hooks,配合高级状态管理。

  • 示例库:提供即用于 ChatGPT 和 Claude 的电商、旅行、SaaS 等场景应用示例,助你快速上手。

以下团队选择使用 Skybridge 构建他们的 MCP 应用:

快速开始

面向 Agent

安装我们的 skill 以构建 MCP 应用和 ChatGPT 应用:

npx skills add alpic-ai/skybridge -s skybridge

安装完成后,向你的 Agent 询问"你有哪些技能?"进行确认,然后尝试:

  • 创建一个新的 MCP 应用

  • 将我的 MCP 服务器迁移到 Skybridge 框架

  • 为我的 MCP 应用添加新视图

面向人类开发者

通过以下命令初始化新项目:

npm create skybridge@latest my-app

完整安装说明请参阅 快速入门指南

文档

Skybridge 文档 覆盖构建 MCP 应用的完整生命周期:

  • 基础概念:了解 MCP 应用、ChatGPT 应用,以及 Skybridge 如何桥接两种运行时。

  • 核心概念:学习服务器 <> 模型 <> UI 的数据流、LLM 上下文同步、类型安全,以及通过开发工具实现的即时本地迭代。

  • 指南:使用工具、视图、状态和模型通信构建真实的应用行为。

  • API 参考:浏览我们的 MCP 服务器 API、React hooks、CLI 命令及运行时兼容性说明。

部署

Alpic 上即时部署 Skybridge 应用,享受可扩展的托管服务、MCP 专项分析、永久隧道、应用商店合规审计与提交协助。你也可以在任何兼容 Node.js 的平台上自行托管。

完整生产部署流程请参阅我们的 部署指南

社区与贡献

我们非常欢迎你参与改进 Skybridge。以下是几种参与方式:

  • Bug 反馈:如果你遇到 bug 或非预期的行为,请在 GitHub 提交 Issue,并附上清晰的复现步骤。

  • 问题与想法:在使用 Skybridge 构建应用时遇到问题,或对框架、文档、示例、开发体验有改进想法?欢迎提 Issue 或在我们的 Discord 中分享。

  • Pull Request:提交代码或文档变更前,请先阅读贡献指南,再开启 PR。

Skybridge 基于 MIT 许可证 发布。

贡献者

HarijoeFred Barthelet 以及 Alpic 团队用 ❤️ 共同构建与维护。

示例模板

在文档的 示例 章节中探索我们所有的示例模板。

基础

| 预览 | 应用 | 描述 | 演示 | 代码 |

| | Everything | 综合演练场应用,展示 Skybridge 所有 hooks 与功能。 | 查看演示 | 查看代码 |

应用场景

| 预览 | 应用 | 描述 | 演示 | 代码 |

| | Capitals Explorer | 交互式世界地图,支持地理定位、国家信息查询与动态首都探索。 | 查看演示 | 查看代码 |

| | Flight Booking | 航班搜索轮播,含路线详情、价格比较与外部预订跳转。 | 查看演示 | 查看代码 |

| | Ecommerce Carousel | 商品轮播,支持持久化购物车、本地化、主题切换与模态弹窗。 | 查看演示 | 查看代码 |

| | Investigation Game | 多屏幕悬疑游戏,支持全屏模式、动态剧情推进与上下文异步演示。 | 查看演示 | 查看代码 |

| | Productivity | 交互式数据分析仪表盘,含图表、主题适配、本地化、全屏模式与双向工具调用。 | 查看演示 | 查看代码 |

| | Time's Up | 文字猜谜派对游戏,用户给出提示,AI 进行猜词。 | 查看演示 | 查看代码 |

| | Lumo — Interactive AI Tutor | 自适应 AI 导师,支持 Mermaid 图表、思维导图、测验与填空练习。 | 查看演示 | 查看代码 |

身份认证

| 预览 | 提供方 | 描述 | 代码 |

| | Clerk | 基于 Clerk 的完整 OAuth 认证,含个性化咖啡店搜索。 | 查看代码 |

| | WorkOS AuthKit | 基于 WorkOS AuthKit 的完整 OAuth 认证,含个性化咖啡店搜索。 | 查看代码 |

| | Stytch | 基于 Stytch 的完整 OAuth 认证,含个性化咖啡店搜索。 | 查看代码 |

| | Auth0 | 基于 Auth0 的完整 OAuth 认证,含个性化咖啡店搜索。 | 查看代码 |

UI 与组件库

| 预览 | 应用 | 描述 | 演示 | 代码 |

| | Manifest UI | 面向丰富 AI 体验的 Agentic 组件库示例。 | 查看演示 | 查看代码 |

| | Generative UI | LLM 生成的动态 UI,基于 json-render 与 36 个预构建的 shadcn/ui 组件。 | 查看演示 | 查看代码 |

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

星核 AI 实验室

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值