@happyvertical/smrt-mcp-openai

中文文档
0.62.1发布于 2026/11/17MITTypeScriptES Module近 30 天下载 1.7万

SMRT MCP Apps 的可选 OpenAI 导航和设置

中文使用文档
文档目录5 节
  1. 合同和范围
  2. 服务器组成
  3. 浏览器导航和倒置
  4. 背景、信息和作曲者提到
  5. 审定和证据

@happyvertical/smrt-mcp-openai (英语)

可选导航,设置,上下文,消息和提及 s-m-r-t MCP Apps. 普通的S -m -r -t应用程序没有 导入此软件包。 这个 ./client 条目是只使用浏览器并取决于 便携式 @happyvertical/smrt-mcp-apps 桥; 根项由已存在的 app-MCP工作流程不创建另一个服务器或授权政策.

合同和范围

该套软件包执行下列儿童的导航/设置和背景/信息/感知: 3202号 下划线 M0 集成标准数字 :

  • 全球和线程条目元数据 {}。 。 。 .
  • 结构化原始设置和权限过滤布局动作; 现代 发现广告 capabilities.extensions['openai/settings'] 仅在 两个设置工具都在请求的授权目录中.
  • 资源显示模式元数据和可移植显示请求,并带有内置倒计时.
  • 经验证的本地/网络应用程序链接和观察到的主机深层链接通过一个 已存在的域授权读取工具.
  • 登机申报表;包装技能/资产核查属于M7.

精确基线 : OpenAI 扩展光谱 e314720, (中文(简体) ), 在协调世界时2026-09-30日重新认证为上游主干线 正式扩展指南 财务报告和审定财务报表 用户界面指南. SDK v1 (英语) OpenAI 帮助者是故意不依赖的. 服务器运输使用本地 范围 MCP SDK 2.0.0 / 协议 2026-07-28; 浏览器应用 2026-01-26。 。 。 .

仅宣布已执行的特性。 文件/表格仍然是单独的计划M6儿童。 设置支持布林斯,字符串/enums/长边框, 数字/输入器/距离/多边。 任意的regex模式是明确的 拒绝以避免运行未绑定的图案; 应用程序可以使用 enum 或 一个已存在的域验证符。 没有静默的降级计划发生. 元数据为 以64 KiB为界,深度为16;设置为64字段,字符串为4096字符, 路线到2048字符。 未知字段/ 类型已关闭 .

服务器组成

使用 withOpenAiEntrypoints(existingReadWorkflow, ['global', 'thread']) 通过 的结果 createMcpAppServer({ workflowTools })保留 处理器和便携式 _meta.ui.resourceUri初步工具成果仍然 没有重复的进入点呼叫。 给出线索视图不同的描述性标题.

bindOpenAiSettings({ schema, read, update, server: () => appServer }) 包裹两个 现有工作流程定义。 添加其内容 workflows 到服务器上,然后挂载 与 extensions: ({ tools }) => settings.extensions(tools)复选运行 打开 server/discover 使用相同的经核实的主目录和经过过滤的目录 用于发现工具。 说明或扩展元数据都不允许.

读取处理器返回 structuredContent: { schema, values, layout? },带有 每个财产的价值。 更新处理器收到 { set: { changedField: value } } 返回时 structuredContent: { values }。更新是绝对值任务, 不切换或递增。 约束性核查其宣布的读取/写出效果, 需要一能的指派,验证投入/产出,并永不重复.

业主必须批准资源所有权,重新检查现租户 并持续使用现有执行人和 修订政策. 适配器不提供持久性,交易守护, 或域批准。 主机电线合同没有修订参数;不添加 一个被发明的字段。 需要人力审查/修订标志的工作流量应保留 而不是强迫它进入本地环境。 测试 运行自有的 SQLite 交易, 守护更新, 滚回和重试 .

过 openAiDisplayMetadata({ availableDisplayModes: ['inline', 'fullscreen'], preferredDisplayMode: 'fullscreen' }) 作为已宣布的资源 metadata。 。 。 . 资源安全元数据和文摘仍为应用MCP所拥有. pip 不属于 上面写着OpenAI显示合同 输入字段保存上游默认值; 首选项仍然是提示.

openAiOnboardingDeclaration('./skills/setup/SKILL.md') 仅返回 { extensions: { 'com.openai': { onboardingSkill: ... } } }合并到 插件显示; 它不安装或执行该技能 .

浏览器导航和倒置

导入 ./client,通过现有的 McpAppBridge 改为 observeOpenAiNavigation({ bridge, resolveTool, onResult, onFallback })电话 卸载时返回的处置者。 它的消耗范围 rawHostContext 从 桥的验证来源/来源和寿命周期,仅承认 openai/deepLink: { url },并使用 { url }。 。 。 . 域工具必须拒绝被猜测或交叉租户对象. 服务器应用程序 可使用 resolveOpenAiNavigationTarget 只发送授权的读取工具.

重复的相同路线不重复呼叫; 新路线取消旧请求 并且忽略了陈旧的答复。 URL是相适应的,无碎片的,无逆向的, 并拒绝协议相对、双编码和控制特征表格。 处理 查询参数作为不信任输入,绝不作为身份或批准。 字义 查询分隔器在路径名解码之前分离, 所以编码了问号 无法隐藏向上段 。 查询值中类似 Traversal 的文本仍然合法 .

只有被拒绝的工具呼叫或 isError 结果选择 denied 倒计时. 消费者回调例外并非授权失败, 也绝不重试 倒计时。 回调会处理自己的渲染错误; 未发现的例外 在一个同步的结果/倒计时回调中,作为未处理的承诺拒绝.

createOpenAiAppLink 释放被绑住的桌面( e)codex),移动(chatgpt)或网络 格式,有单独编码的插件/工具/路径组件. openAiNavigationLink 需要明确 'present' 支持选择本地链接; 'absent'不详 或错误支持使用配置的 HTTPS 应用程序 URL。 此支持投入 是一个部署/观察者的决定, 未发明的 MCP 能力字段。 。 。 . 入境点/登入点同样没有贴有标签的客户广告; 保留普通工具/设置导航。 本地结构设置为 选项:相同的设置工具和应用程序设置页仍然可用.

requestOpenAiDisplayMode 使用经商的便携式模式; 缺少/未知模式 或被拒绝的请求返回 'inline'。UI必须保留其内在 当导航无法解决时,布局和制成普通链接.

背景、信息和作曲者提到

浏览器消费者导入 updateOpenAiModelContext 从 ./context 财务报告和审定财务报表 sendOpenAiMessage 从 ./messages。服务器消费者导入 withOpenAiMentionSearch 财务报告和审定财务报表 resolveOpenAiMentionSelection 从 ./mentions。 。 。 . 这些子路径共享现有的可移植桥和授权的app-MCP服务器.

updateOpenAiModelContext({ bridge, value, native }) 将上下文替换为 { text: { text, title?, thumbnail? }, structuredContent? }文本为非空并 最多16384个字符; 标题限制为512个. 设定 background: true 的文本值,以发送仅限助手的受众 元数据; 背景是演示文稿 提示, 非隐私边界:模型/提供者仍然收到上下文. 只发送该收件人授权的数据 。 谈判 openai/modelContext 使用提供的本地调用。 缺少支持或本土故障倒计时 改为可移植文本和结构化内容,没有本地元数据。 中止/处置 防止后退.

sendOpenAiMessage({ bridge, value, native }) 接受文本,并 target: 'active' (默认)或 'new'。主动对话可以使用便携式短信. 新对话需要谈判 openai/message 和本土召回; 在信件到达活动方之前, 丢失或错误支持拒绝 谈话 未知目标/模式无法关闭, 发送没有重试 .

withOpenAiMentionSearch(existingReadWorkflow) 声明只使用应用程序的作曲搜索 元数据和 a { query } 输入(最多256个字符,包括空搜索). 它自己的处理器返回 structuredContent: { items },最多25个 { type: 'resource', resourceUri, title, subtitle?, icons? } 条目。 处理 是非空的不透明字符串,最多为2048个字符;标题/子标题是 非空地,并被限制在512。 最多8个图标都要求 src (2048年), (中文(简体) ), 可选 mimeType (128) 最多8个非空地 sizes 字符串( 每个32个), 财务报告和审定财务报表 theme: 'light' | 'dark'。未知字段和错误的数值拒绝. 已出版的输出计划描述了这些相同的被关闭对象和限制.

搜索结果就是发现提示,从不授权. 传递精确 已返回 resourceUri 作为当前选择工作流程的参数 resolveOpenAiMentionSelection({ server, tool, arguments, principal })编辑 应用程序提供可信、新解决的本金; 应用- MCP 政策 重新检查演员、现租户、范围和每个电话的会员资格,以及 拥有工作流程重新检查处理所有权。 永远不要从手柄中获取身份, 浏览器元数据或搜索时间权限 。 我猜,交叉租借电话和 搜索后撤销不能选择私人数据 。 此帮助添加了否 选择处理器、身份提供者、持久性或授权政策.

审定和证据

运行 pnpm install,然后记录到依赖性构建和包口:

pnpm exec turbo build --filter=@happyvertical/smrt-mcp-openai...
pnpm --filter @happyvertical/smrt-mcp-openai typecheck
pnpm --filter @happyvertical/smrt-mcp-openai test
pnpm --filter @happyvertical/smrt-mcp-openai test:e2e
pnpm --filter @happyvertical/smrt-mcp-openai verify:pack

行为/威胁矩阵在 TEST-DESIGN.md (中文(简体) ). 礼宾测试 使用 SDK 客户端和 HTTP 挂载, 包括 JWKS/ MCP 套接字 通过公开的 M2 认证网关, 并附有符号、 演员、 租户和撤销拒绝; 浏览器套件使用真实的 Chromium 沙盒式iframe 有无网络 CSP并构建了浏览器输出. 包装出口 检查声明和浏览器/服务器边界。 现有应用程序- MCP 完整 成套/类型检查/包件和便携式桥门也适用于集成变化. 协调员安排所有根口和独立审查.

未声称实际 OpenAI 主机兼容性 . 合成主机没有 证明桌面、工作网络、iOS、Android或账户滚动支持。 没有配置 提供了OpenAI主机连接或可部署注册的合成插件; 记录准确的主机/建设/平台、认证配置、资产修订和观察 导航/设置结果,然后要求支持的宿主接受。 这个 上游支持矩阵仅是预期支持;网络指Work,不包括 经典的ChatGPT. M8型机车的实际接收仍开放.

版本与发布记录

@happyvertical/smrt-mcp-openai 共发布 128 个版本,首次发布于 2026/10/15;过去 12 个月发布了 128 个版本。

版本发布日期距今
0.62.1latest2026/11/17今天
0.62.02026/11/17今天
0.61.62026/11/161 天前
0.61.52026/11/161 天前
0.61.42026/11/161 天前
0.61.32026/11/152 天前

关于 @happyvertical/smrt-mcp-openai 的常见问题

@happyvertical/smrt-mcp-openai 是什么?

SMRT MCP Apps 的可选 OpenAI 导航和设置

如何安装 @happyvertical/smrt-mcp-openai?

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

@happyvertical/smrt-mcp-openai 支持 TypeScript 吗?

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

@happyvertical/smrt-mcp-openai 支持 ESM 还是 CommonJS?

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

@happyvertical/smrt-mcp-openai 可以商用吗?

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

@happyvertical/smrt-mcp-openai 的下载量有多少?

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

@happyvertical/smrt-mcp-openai 还在维护吗?

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