@guuey/mcp-apps-host

中文文档
0.36.0发布于 2026/11/15MITTypeScriptES Module构建来源已验证近 30 天下载 8836

MCP应用程序(SEP-1865) guuey聊天表面的主机角色——从UI频道缩小取景-挂载,ui://locator通过资源/读取进行回水,和沙盒-托拉斯频道合同. 供应商中性:任何跟踪MCP App上载着它.

中文使用文档

@guuey/mcp-apps- host (英语)

这个 东道主 作用 MCP应用软件(SEP-1865) 用于 Guuey 的聊天表面—— 以及任何挂载 MCP Apps 视图的主机.

光谱的常量是"Host MUST..." 此套件执行 角色的客户端缩小并挂起合同:

  • 视图挂载发送 (单位:千美元)toolResultViewMount, (中文(简体) ), snapshotViewMount: 一个 缩小答案,“如果有的话,这个街区会是什么?” 内线 ui:// 资源有效载荷, 或裸体 ui:// 定位器 (从) uiData.resourceUri,则 structuredContent.resourceUri) (中文(简体) ). 每个 ui:// 制片人 ggui's ggui_render 包括定位器制作人:ggui供应商快速路径 2026-08-16 (guuy#209) 休养后,一旦舱的活读取门和ggui's 读取时间薄荷使 spec 读取路径比任何新 内衬的靴子。 其帮助者将一名未成年人输出为 @deprecated。 。 。 .
  • 定位器还水:持续 ui:// 定位器由一新机重挂, 认证 resources/read 的图案模板 获取( 光谱本身推迟持久性/ 恢复; 完整重载) 额外欠视图 ui/notifications/tool-input + 其工具 结果)——从不通过重放存储的挂载材料. 读取的传输器被注入 (单位:千美元)UiResourceReader);东道主拥有认证和用户所有权执行权, 否认与失职是同义的.
  • 一般阅读器组装 (单位:千美元)createMcpUiResourceReader: 递给它一个 主机拥有 resources/read 可调用( 原始 MCP 客户端, 认证) 代理 - 没有强制使用 SDK 依赖)并获得一个 UiResourceReader 回来,与 信任规则构建在: 拒绝 == 女士 == 占位符 和沙盒 频道来源于 请求 定位器为 uri, 永远不要回答 (单位:千美元)uiResourceChannel) (中文(简体) ). @guuey/agent-client是因为 createUiResourceReader 实值 这个集合在guuey的平台代理.
  • 沙盒-信托频道 (单位:千美元)ViewMountChannel: 哪一个沙盒主机页 a 有效载荷可能载入,直到资源申报的CSP建筑用地.
  • 东道主本身 (单位:千美元)attachViewHost,以及 <GuueyView> 从 @guuey/mcp-apps-host/react: 与 ui/initialize 握个手 块在上面 单装材料 使一个空白框永远. attachViewHost(iframe, config) 答题 任何嵌入器的握手(框架-不可知,一个呼叫) iframe 创建、生命周期和保险 沙盒默认( s)allow-scripts 无 allow-same-origin 与 它,代理生成的 HTML 将作为您的来源运行 allow="clipboard-write" 因此生成的复制按钮工作). 可配置 其宿主各有不同之处: hostCapabilities (默认) {} —— 说 只有广告你执行),可选 tools/call 中继钩 (优先边界,默认关闭;配对 createMcpUiActionRelay, (中文(简体) ), hostContext和谈判暂停。 虽然一个框架谈判 状态为标签( n)negotiating 编号 : connected 编号 : no-handshake从不 空白页.
  • 仅确定挂载行走 (单位:千美元)resolveViewMount: 把它锁上 toolResultViewMount编号 :snapshotViewMount 与你的阅读和渲染 仅限 ResolvedViewMounts) 定位器回转折入.

供应商原则上中立:ggui的MCP 应用程序运行在任何光谱跟踪主机上 (claude.ai, changpt.com, guuey) 正是因为他们遵循了谱;这个 软件包是 Guuey 的 OSS 主机侧支持 .

遵约状况和路线图: docs/development/mcp-apps-host-conformance.md 在 guuey (guuey# 123) 中.

支助

问题和帮助:Discord上的贵人社区—— https://guuey.com/discord (英语)。 。 。 . 错误和特性请求 : https://github.com/wisguuey/guey-sdks/ 问题。 。 。 .

版本与发布记录

@guuey/mcp-apps-host 共发布 72 个版本,首次发布于 2026/08/08;过去 12 个月发布了 72 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.36.0latest2026/11/152 天前
0.35.02026/11/116 天前
0.34.02026/11/0610 天前
0.33.02026/11/0610 天前
0.32.02026/11/0610 天前
0.31.12026/09/291 个月前

其他发布通道:next → 0.16.15。

关于 @guuey/mcp-apps-host 的常见问题

@guuey/mcp-apps-host 是什么?

MCP应用程序(SEP-1865) guuey聊天表面的主机角色——从UI频道缩小取景-挂载,ui://locator通过资源/读取进行回水,和沙盒-托拉斯频道合同. 供应商中性:任何跟踪MCP App上载着它.

如何安装 @guuey/mcp-apps-host?

在项目目录运行 npm install @guuey/mcp-apps-host,或使用 pnpm add / yarn add / bun add。

@guuey/mcp-apps-host 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@guuey/mcp-apps-host 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@guuey/mcp-apps-host 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@guuey/mcp-apps-host 可以商用吗?

@guuey/mcp-apps-host 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@guuey/mcp-apps-host 的下载量有多少?

根据 npm 官方下载统计,@guuey/mcp-apps-host 在 2026/10/17 – 2026/11/15 这 30 天内被下载 8,836 次,日均约 295 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@guuey/mcp-apps-host 还在维护吗?

最新版本 0.36.0 发布于 2026/11/15(2 天前);至今共发布 72 个版本,其中过去 12 个月发布了 72 个;首次发布于 2026/08/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。