Nymrel

Nymrel 托管 MCP

https://mcp.nymrel.com/mcp 的生产环境源代码。

公共服务有意仅开放四个无需凭据的只读工具：

• nymrel_audit_website
• nymrel_find_domain
• nymrel_golf_bag_gap
• nymrel_social_clip_score

随附的客户端还包含其他 Nymrel API 契约，但在其提供方或授权边界达到生产就绪状态之前，托管入口会将它们从 tools/list 中移除。

结果契约与审计应用

四个公共数据工具均发布了明确的成功／错误输出架构。 有效的上游载荷会保留其原始字段和证据。缺失或无效的测量值会产生 INVALID_RESULT，并设置 isError: true；安全的上游错误也会带有 MCP 错误位。 文本结果与结构化结果保持一致。

NYMREL_AUDIT_UI_ENABLED=true 会启用第五个匿名只读工具 nymrel_render_website_audit 和 ui://nymrel/website-audit-v1.html。此标志 默认关闭。请先调用审计工具，再将其成功结果和请求的 URL 传递给渲染器。渲染过程不会发出网络请求，也不会验证调用方提供数据的来源。即使没有 UI，数据工具仍然有用。视图会将缺失的测量值标记为未知，并使用文本节点呈现所有报告内容。

托管资源为 api/assets/audit-widget.html；它独立于较旧的 TypeScript 测试框架所采用的更丰富签名报告格式。在安装锁定的 Node 依赖项和 Playwright Chromium 后，请从仓库根目录运行 node scripts/audit-ui-smoke.mjs，以测试托管资源。CI 会在 Linux/Node 24 上运行此合成托管检查。它不能替代 ChatGPT 验收测试。

部署后，运行 scripts/verify_live_contract.py --public-results，以检查新输出架构。在审查部署中启用视图后，添加 --audit-ui；该选项会检查确切的目录、资源元数据和合成渲染。对于已启用 Remote reads 的部署，还需提供 --remote-read --issuer https://nymrel-remote-production.up.railway.app（issuer 末尾不能有斜杠）。验证器的默认设置仍与较早的线上目录兼容，便于比较发布版本。

启用生产 UI 之前，请刷新 ChatGPT 工具目录并运行 evals/workflow-adoption-cases.json：数据到视图的流程、文本回退、移动设备、 主题更改、错误和不可信页面内容。记录已部署的提交、主机、时间戳和证据。将标志设为 false 即可回滚视图；重新部署前一个版本即可回滚完整的契约更改。

Remote reads 会保留其后端载荷。待处理结果必须包含一个明确且非空的 call.id 或 callId；格式错误的待处理结果会安全失败。_meta["nymrel/readState"] 提供恢复工具，并禁止重新提交原始操作。插件技能会将每轮状态检查次数限制为三次；代理本身只会进行一次后端调用，绝不会自动重放。

请参阅 ../docs/chatgpt-workflow-adoption-2026-09-29.md，了解有源代码依据的决策、验证信息和剩余的目标主机门槛。

公共工具工作台

NYMREL_TOOLS_UI_ENABLED=true 会独立添加 nymrel_open_tools 和 ui://nymrel/tools-v1.html。打开器接受来自全局导航或线程的 {}，并且 仅返回包含四个工具的目录。启动时不会运行任何分析。 该视图使用捆绑的 MCP Apps SDK，并在提交表单时调用现有数据工具。 它仅支持全屏模式，并应用宿主主题和深层链接。应用内偏好设置仅在此浏览器中保存显示选项； 不会持久保存已提交的输入和结果。单独的用户按钮会在宿主支持时，将所选结果添加到对话上下文中。

此标志默认关闭，等待宿主验收。从根目录运行 npm run test:ui，并执行真实托管环境下的线路测试。 verify_live_contract.py --tools-ui 会检查启用后的准确目录、入口点、启动、资源以及显示/CSP 元数据；它可与 --audit-ui 和 --remote-read --issuer ... 组合使用。 插件家族清单和验收矩阵请参阅扩展记录。

由激活流程控制的私有交接适配器

此源码还包含一个默认禁用的适配器，用于通过同一 @Nymrel MCP 标签提供两种未来的 身份验证工具：

• nymrel_submit_private_handoff
• nymrel_get_private_handoff_status

公共和私有契约保持分离。四种生产工具仍然是匿名读取工具。 私有提交/状态调用使用调用方令牌，该令牌由直接的 FastMCP RemoteAuthProvider 验证， 随后代理已接受的 /api/agent/v1/handoffs REST 契约。MCP 层不会将 bearer 令牌作为工具参数接收，不会持有共享服务凭据，不会选择项目，也不会授予执行权限。

仅设置 NYMREL_PRIVATE_HANDOFF_MCP_ENABLED=true 不会激活此桥接。 NYMREL_PRIVATE_HANDOFF_OAUTH_ISSUER 必须指定一个由 Nymrel 所有、位于根级别的 HTTPS OAuth 颁发者，其 JWKS 位于 /oauth2/jwks。边缘层仅接受适用于 https://mcp.nymrel.com/mcp 的 RS256 JWT，然后强制要求使用所调用私有工具声明的唯一准确作用域。Nymrel REST API 会独立验证相同声明，并将稳定的提供方 sub 映射到其撤销和项目允许列表策略。无关提供方的令牌会被拒绝（返回 401），且不会触发激活。源代码管理中不包含任何提供方密钥、生产令牌、测试者身份或真实客户内容。

固定版本的 FastMCP 3.4.10 集成不会将 OpenAI 要求的顶层 securitySchemes 字段交由框架隐式处理。托管的 list-tools 适配器会显式发布该字段，并在 _meta 下保留相同值，以兼容较旧的客户端。 契约测试要求每个公共工具都使用 noauth，且每个私有工具都使用准确的 OAuth 作用域。如果私有调用缺少有效令牌或作用域，适配器也会返回完整的 _meta["mcp/www_authenticate"] 挑战。在生产激活前，必须通过目标客户端的 OAuth 金丝雀测试。

验证

可部署的运行环境固定使用 Python 3.13。创建干净环境，并安装经过审查的运行依赖和测试工具：

py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip==26.2.1
.\.venv\Scripts\python.exe -m pip install -r requirements-test.txt
.\.venv\Scripts\python.exe -m pip check
.\.venv\Scripts\python.exe -m ruff check --config pyproject.toml api tests
.\.venv\Scripts\python.exe -m compileall -q api
.\.venv\Scripts\python.exe -m pytest tests -q
.\.venv\Scripts\python.exe -m pip_audit --strict --progress-spinner off -r requirements.txt

私有适配器的仅合成数据门禁如下：

.\.venv\Scripts\python.exe -m pytest tests/test_private_handoff.py -q

部署

将此目录链接到现有的 nymrel-mcp Vercel 项目，运行测试，然后通过现有受保护的发布流程，从此干净提交进行部署。 生产别名就绪后，验证 tools/list，并为每个已发布工具各成功调用一次。源码、PR 或本地测试结果都不能作为部署凭证。

在单独的同意、保留期限、AuthKit 租户、测试者主体、专用存储、项目允许列表和生产合成数据门禁获得批准之前，请勿部署私有功能。在此之前，生产环境的验证范围始终严格限定为四种公共工具。