# @happyvertical/smrt-mcp-apps 中文文档

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

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:53:45.818Z
中文译文更新时间：2026-11-17T09:41:47.756Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：83.2 kB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-15T06:06:03.155Z
- 最新版本发布：2026-11-17T07:53:45.589Z
- 近 30 天下载量：20382（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：128（近 12 个月 128 个）

## 中文简介

便携式 MCP Apps 的框架中立浏览器桥

## 安装

```sh
npm install @happyvertical/smrt-mcp-apps
```

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

## README

# @happyvertical/ smrt- mcp- apps (英语)

框架中立, 只浏览器 **视图边** 便携式MCP Apps的桥. 它不是一个服务器适配器,主机/发售箱执行,授权层或 WebMCP工具注册员. 导入它到构建前不需要浏览器.

## 使用量

```ts
import { McpAppBridge } from '@happyvertical/smrt-mcp-apps';

const bridge = new McpAppBridge({
  hostWindow: window.parent,
  hostOrigin: 'https://trusted-host.example',
  appInfo: { name: 'Opportunity viewer', version: '1.0.0' },
});
await bridge.connect();
if (bridge.snapshot.hostCapabilities.serverTools) {
  const result = await bridge.callTool('opportunity_list', {});
  // Render text with textContent and validate domain-shaped structuredContent.
}
// Owning component unmount:
bridge.dispose();
```

提供直接母窗口及其来自可信部署的确切来源 配置 。 不要从第一个信件、 URL 查询、 不信任中学习 引用或工具参数。 同一窗口和来源仍然对 实例一生。 除了明确的回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回的回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回. 不透明( O)`null`母源和通配符目标故意得不到支持; 一个不透明的即时沙盒代理主机需要经过审查的运输设计. 观点本身可能来源不透明. 主机认证停留在外.

## 支持的合同

固定的上游修订 : `82221c0c8ce7661efa6771c9d461511b1650495f`。 。 。 . 这个 [运行时间计划](https://github.com/modelcontextprotocol/ext-apps/blob/82221c0c8ce7661efa6771c9d461511b1650495f/src/generated/schema.ts) 已执行字段的权威 [协议常数](https://github.com/modelcontextprotocol/ext-apps/blob/82221c0c8ce7661efa6771c9d461511b1650495f/src/spec.types.ts) 实值 `2026-01-26`,独立于服务器 MCP `2026-07-28`。 。 。 . 同一修正案 [传言实例](https://github.com/modelcontextprotocol/ext-apps/blob/82221c0c8ce7661efa6771c9d461511b1650495f/specification/2026-01-26/apps.mdx) 差异 : `ui/message` 显示单顿内容并省略信件/文本模式 能力,而运行时间计划则使用内容阵列,能力模式 对象,需要 `hostContext`,可选的工具输入参数和可选 取消原因 。 合同测试明确标出这些运行时间形状.

已实施方法:初始化/初始化,服务器 `tools/call`, (中文(简体) ), `ui/open-link`, (中文(简体) ), 文本 `ui/message`,文本/结构 `ui/update-model-context`,显示模式请求, 大小通知、拨打和资源拆解。 工具输入/结果/取消 和主机文本通知只能在初始化后接受。 只有一个 接受完整的初始输入和终端结果/取消; 延迟或 命令外更新被忽略。 部分输入被忽略 。 没有应用工具能力 广告; 入境 `tools/call` 获得方法不明。 资源代理、抽样和下载没有内置的输入适配器; a 选入扩展适配器可登记下面的有限度合同。 二进制内容 在内置工具结果和可执行主机CSS中仍然不支持. 未知的能力从未授予一个支持的特性 。 不支持的工具内容 明确拒绝模式。 文本和结构化结果仍然可用,没有 交互能力;消费者必须保留一个正常的应用/审查URL回落.

主机上下文只曝光主题,显示模式(s),平台,地块和时区. 未知的上下文字段被输入的投影忽略; 可执行 CSS/ 工具 定义从未适用. `snapshot.rawHostContext` 财务报告和审定财务报表 `snapshot.rawHostCapabilities` 为选入扩展适配器保留有边框的JSON. 上下文通知合并为原始上下文;能力保持不变 握个手 每个快照/观测器都接收到一个孤立的克隆. 扩展适配器 必须验证自己的字段,并将原始数据视为不可信; 原始能力 无法启用打入方法或绕过其门。 没有全球性的任意RPC方法. 可选适配器必须明确 登记下文所述与能力有关的合同。 未知的支持字段 enum 值无法关闭 。 缺少显示模式 列表只允许内含。 拒绝主机( E)`isError: true`)和RPC错误传播.

有效载荷限制:24个嵌入级,4096个阵列项目,1024个对象键,保守 128 KiB字符/节点预算;文本区块32 KiB,128个;32个待处理请求; 15秒默认超时(可配置 1–120000 ms). 阵列必须是密集的自有数据属性,没有命名/同义属性;其延时器从未被引用. 周期/非JSON/用户和 原型密钥被拒绝 。 请求使用 printance 随机关联的ID . 超时, 中止和处理拒绝等待的呼叫, 并发送最佳的取消 . 处理删除收听器, 中止 `signal`,并清除观察者。 取消 不是一个回滚保证:服务器工作流程保留一能/交易规则.

## 丝绸和挂起的相互作用

明确导入 `useMcpApp` 财务报告和审定财务报表 `useMcpAppIntent` 从 `@happyvertical/smrt-svelte/mcp-apps`。 。 。 . `useMcpApp(() => options)` 仅建构于 在卸载上挂载和处置;其状态包含 `bridge`, (中文(简体) ), `snapshot` 财务报告和审定财务报表 `error`。 。 。 . 使用 `bridge.signal` 或用于相关同步工作的自有中止信号.

`useMcpAppIntent(intent, binding)` 绑定现有的公众视图提示声明 到挂载的控制交互Registry或DataSurfaceRegistry。 它利用公众 `compileViewIntentToolSpec` 执行和无要求 `document.modelContext`。 。 。 . 它是一种可调用的地方组件,从未作为远程工具转发或发布. 控制提案仍由代理人提供;现有可信赖的人类阶段审查拥有 应用值。 该组成部分拥有注册登记及其清理. 没有引入新的REST引擎,浏览器权限引擎或最终提交API.

## 验证

之后 `pnpm install` 和有文件证明的依赖关系构建:

-   `pnpm --filter @happyvertical/smrt-mcp-apps build`
-   `pnpm --filter @happyvertical/smrt-mcp-apps typecheck`
-   `pnpm --filter @happyvertical/smrt-mcp-apps test`
-   `pnpm --filter @happyvertical/smrt-mcp-apps test:e2e`
-   `pnpm --filter @happyvertical/smrt-mcp-apps verify:pack`
-   `pnpm --filter @happyvertical/smrt-svelte check`
-   `pnpm --filter @happyvertical/smrt-svelte exec playwright test -c e2e/playwright.config.ts mcp-apps.spec.ts`

Chromium主机固定器捆绑着一个Iolaus形状的合成列表/详细取景器, 通过公共 M3 资源 API 编写和读取它,以及路由主机代理 电话通过 `createMcpAppServer` 有服务器的合成本能. 它检查资源摘要/MIME/CSP元数据以及被撤销的资源/工具拒绝, 原始生成了低于 100 KiB 的 HTML , 并且无外部的散列脚本/ 风格 CSP 网络/资产。 浏览器闸门覆盖有敌意的信息, 能力缺失, 重复拆卸/重接、 过时替换结果和键盘导航 320/390px 无横向溢出. 可见审查 URL 包接并保留 即使沙盒政策块打开了新窗口,也可以复制. Svelte 浏览器固定程序使用真实的公共注册和一个真实的 Playwright点击以应用一个有阶段的建议书;捏造的批准被拒绝. 这些固定装置只证明合成浏览器的行为. 没有实际的 OpenAI 或其他 请求外部主机兼容性 。 M3资源元数据仍需要 主机可执行 CSP 和沙盒权限; 浏览器桥无法执行 代表它的东道主政策。 参考视图只打开一个人文审查 URL和 没有候选记录或传送/核准操作.

## 任择延期合同

`bridge.registerExtension(definition)` 返回 a `McpAppExtension` 仅在 Apps 握手完成,声明的能力路径选择平原 对象在初始化主机能力中。 申报是可信赖的本地编码; 从未从主机/模型输入中获取能力路径或方法列表 。 例如:

```ts
const resources = bridge.registerExtension({
  id: 'example.resources',
  capability: { path: ['experimental', 'example/resources'] },
  methods: ['resources/read', 'resources/subscribe', 'resources/unsubscribe'],
  notifications: ['notifications/resources/updated'],
});
const unsubscribe = resources.subscribe((method, params) => {
  // Adapter validates its exact URI/schema/ownership before acting.
});
const result = await resources.request('resources/read', { uri: 'test://fixture' });
// Validate the extension's exact result schema before consuming it.
unsubscribe();
resources.dispose();
```

如果电线能力宣布一个版本,请指定 `capability.version: { key: 'version', supported: ['1'] }`; 不匹配拒绝. 关闭这个领域的能力 没有有线版本 而不是发明一个. 桥梁副本申报和许可证最多16份,16份请求 每个登记单位有16个通知人和32个听众. 重复的ID/方法所有权、未列出的请求、保留寿命周期/工具方法 和畸形的JSON拒绝。 未知通知被忽略; 主机请求永远不会 援引通知回调。 每个观察者都收到孤立的受限数据.

土著 `ui/message` 财务报告和审定财务报表 `ui/update-model-context` 是狭义的允许列表例外 用于扩展元数据:核心能力和文本/结构化模式门, 用户角色、文本内容形状/限制和失败结果检查仍然适用 增加扩展能力。 没有图像模式或工具调用绕行 介绍。 扩展适配器拥有语义元数据/结果验证和任意 额外的申请授权,而不是这个运输API.

手柄共享现有的约束主机/原产地,JSON预算,32-待决限制, 相关ID和超时行为. `signal` 手柄或桥接处置中止; 等待工作的拒绝和后期通知/结果无法恢复手柄. 新的注册拥有新的一生. 适配器应请求远程未订阅 ; 立即终止拆解, 不等待 主持人确认。 这是取消,不是服务器回滚的保证.

## 常见问题

### @happyvertical/smrt-mcp-apps 是什么？

便携式 MCP Apps 的框架中立浏览器桥

### 如何安装 @happyvertical/smrt-mcp-apps？

在项目目录运行 npm install @happyvertical/smrt-mcp-apps，或使用 pnpm add / yarn add / bun add。

### @happyvertical/smrt-mcp-apps 支持 TypeScript 吗？

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

### @happyvertical/smrt-mcp-apps 支持 ESM 还是 CommonJS？

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

### @happyvertical/smrt-mcp-apps 可以商用吗？

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

### @happyvertical/smrt-mcp-apps 的下载量有多少？

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

### @happyvertical/smrt-mcp-apps 还在维护吗？

最新版本 0\.62\.1 发布于 2026/11/17（今天）；至今共发布 128 个版本，其中过去 12 个月发布了 128 个；首次发布于 2026/10/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

