# @guuey/mcp-apps-host 中文文档

规范地址：https://npmcn.com/package/%40guuey/mcp-apps-host/

版本：0\.36\.0
npm 元数据更新时间：2026-11-14T17:05:07.254Z
中文译文更新时间：2026-11-17T04:06:12.823Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40guuey/mcp-apps-host
原文对照：https://npmcn.com/package/%40guuey/mcp-apps-host/?lang=original
项目主页：https://guuey.com/
源码仓库：https://github.com/withguuey/guuey-sdks

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：564 kB，87 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：3 个
- peer 依赖：react \>=18
- 首次发布：2026-08-08T06:14:03.203Z
- 最新版本发布：2026-11-14T17:05:05.515Z
- 近 30 天下载量：8836（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：72（近 12 个月 72 个）

## 中文简介

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

## 安装

```sh
npm install @guuey/mcp-apps-host
```

也可以使用：`pnpm add @guuey/mcp-apps-host`、`yarn add @guuey/mcp-apps-host`、`bun add @guuey/mcp-apps-host`

## README

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

这个 **东道主** 作用 [MCP应用软件(SEP-1865)](https://github.com/modelcontextprotocol/ext-apps) 用于 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` 与你的阅读和渲染 仅限 `ResolvedViewMount`s) 定位器回转折入.

供应商原则上中立: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://guuey.com/discord)。 。 。 . 错误和特性请求 : [https://github.com/wisguuey/guey-sdks/ 问题](https://github.com/withguuey/guuey-sdks/issues)。 。 。 .

## 常见问题

### @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 和提交记录判断。

