Nominal MCP Server

一个用于 Nominal 硬件测试平台的 MCP 服务器。无需离开编辑器，即可从 Claude Code、Cursor 或任何 MCP 客户端拉取测试数据、检查遥测通道、运行分析并写回结果。

实现 MCP 2026-07-28（当前修订版），并向后兼容 2025-11-25、2025-06-18、2025-03-26 和 2024-11-05。

10 tools  ·  467 API operations reachable  ·  2,992 tokens of tools/list  ·  OAuth 2.1

快速开始

目前还没有公共实例在运行。 大约两分钟即可部署你自己的实例—— 它在 Cloudflare 的免费套餐上运行得很轻松。

部署它

git clone https://github.com/elirapport1/nominal-mcp && cd nominal-mcp && npm ci
npx wrangler login
npx wrangler kv namespace create OAUTH_KV      # paste the id into wrangler.toml
openssl rand -base64 32 | npx wrangler secret put TOKEN_SECRET
openssl rand -base64 32 | npx wrangler secret put HANDLE_SECRET
npx wrangler deploy

连接到它

claude mcp add --transport http nominal https://<your-worker>.workers.dev/mcp

浏览器窗口会打开。粘贴你自己的 Nominal API 密钥（Nominal 应用 → 设置 → API 密钥）。 该密钥会被加密成一个限定于此服务器的访问令牌，并且永远不会以明文存储。 对 Nominal 的每个请求都使用你的凭据发出，因此连接所能看到的内容绝不会超过你账户本身所能看到的范围。

或者通过 stdio 运行它

NOMINAL_API_KEY=<key> \
NOMINAL_MCP_URL=https://<your-worker>.workers.dev/mcp \
npx github:elirapport1/nominal-mcp

（直接从仓库运行——没有发布到 npm，所以直接使用 npx nominal-mcp 无法解析。）

如果你的 Nominal 不是 GovCloud 部署，还需要设置 NOMINAL_BASE_URL—— 商业版是 https://api.nominal.io/api，并且接受 *.nominal.io 下的私有云和本地部署主机。

根据 MCP 认证规范，stdio 服务器从环境变量中读取凭据，而不是运行 OAuth 流程。不会向磁盘写入任何内容。

Related MCP server: Apollo Universal MCP Server

你可以要求什么

“找到发动机 A 上最近一次热试车运行，并告诉我燃烧室压力是否曾超过 900 psi。”

“比较第 14 次和第 15 次运行之间的阀门指令延迟。”

“在此次运行的 T+4.2s 处标记一个事件，并将其标注为 anomaly。”

工具

此外还有 nominal:// 下的资源，以及四个工作流提示词（investigate_anomaly、compare_runs、summarize_run、preflight_check）。

三个值得了解的设计决策

467 个操作，10 个工具。 Nominal 的 API 在 57 个服务中拥有 467 个端点。如果将它们作为工具模式暴露出来，在你输入任何内容之前，tools/list 就会消耗大约 163,000 个 token。相反，nominal_api_search 返回操作描述符，nominal_api_call 执行它们，因此你每实际查找一个操作只需支付约 120 个 token。tools/list 保持固定在 2,992 个 token，并且可以公开缓存。

没有任何工具会返回数据集。 单次运行可能包含数 GB 的时间序列。nominal_query_channels 返回统计信息，以及一条抽稀为最多 200 个桶的最小/最大/均值轨迹，外加一个签名句柄。批量数据通过预签名 URL 传出，绝不会进入上下文窗口。

你的凭据，而不是我们的。 没有服务账户。OAuth 流程将你的 Nominal API 密钥绑定到一个加密的、绑定受众的、一小时内有效的访问令牌中。Nominal 自身的授权是唯一的执行层——MCP 服务器绝不会扩大访问范围，也绝不会实现并行的权限模型。

文档

• SPEC.md — 实现规范：协议决策、工具设计、认证 模型、限制、威胁模型，以及有意省略的内容

• docs/SPEC-original.md — 原始设计简报，留作 记录；SPEC.md §0 说明了测量在哪些地方改变了它

开发

npm ci
npm run typecheck
npm test              # 115 unit + conformance tests
npm run budget        # fails if tools/list exceeds 3,000 tokens
npm run test:fuzz     # adversarial suite
npm run dev           # wrangler dev

测试

验证边界： 协议、认证、限制和目录策略层已完全覆盖。tier-1 工具的 Nominal 侧请求编码是从生成的 nominal-api Conjure 客户端派生而来，并针对桩（stub）进行了测试，而不是针对真实的 Nominal 部署——参见 SPEC.md §9.3。如果你有密钥，一条命令即可弥补这一差距。

模糊测试器每 20 分钟针对真实部署运行一次（.github/workflows/fuzz.yml）。生成器覆盖 JSON-RPC 结构、协议/时代矩阵、工具参数、目录操作 ID、认证伪造以及提示注入/SSRF 载荷。不变量：绝不出现 5xx，始终是有效的 JSON-RPC，绝不反射秘密或堆栈跟踪，resultType 仅在现代协议中存在，延迟和大小有界，且任何内部操作都不会执行。失败时会使用种子提交一个问题，以便精确重放。

部署你自己的

npx wrangler kv namespace create OAUTH_KV     # put the id in wrangler.toml
npx wrangler secret put TOKEN_SECRET          # AES-GCM key material
npx wrangler secret put HANDLE_SECRET         # HMAC key for result handles
npx wrangler deploy

对于 CI 部署，请设置 CLOUDFLARE_API_TOKEN 和 CLOUDFLARE_ACCOUNT_ID 密钥，以及 DEPLOY_URL 仓库变量。

容量

对扩展至关重要的设计特性：一次工具调用不会写入任何存储。

访问令牌是自包含的加密信封，而不是指向会话存储的指针，因此验证一个令牌只需一次解密和几次比较——热路径上无需读取 KV。速率限制使用 Cloudflare 的边缘绑定，同样不会写入任何内容。唯一的 KV 写入发生在 OAuth 授权期间：每个用户每次登录大约三次，此后不再有。

这意味着请求量受你的 Workers 请求限制约束，而不是存储配额；一个部署可供使用的人数受每日新增登录数约束，而不是受使用强度约束。

第一个实现并非如此。速率限制器在 KV 中计数请求——每个请求一次读取和一次写入——在 Cloudflare 的免费套餐上，这会导致服务器在每天大约一千个请求后停止。请查看你套餐的当前限制，但大致情况是：现有用户的高强度使用几乎免费，只有新用户接入才会触及存储。

/health 会报告当前生效的是哪个速率限制器（binding 还是 isolate-fallback），如果部署静默回退，部署冒烟测试将失败。

端点

许可证

MIT