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

빠른 시작

아직 공개 인스턴스가 실행 중이 아닙니다. 약 2분 안에 직접 배포하세요 — 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 토큰이 소요됩니다. 대신 nominal_api_search는 작업 설명자를 반환하고 nominal_api_call이 이를 실행하므로 실제로 조회하는 작업당 ~120 토큰만 지불하면 됩니다. tools/list는 2,992 토큰으로 고정되어 있으며 공개적으로 캐시할 수 있습니다.

어떤 도구도 데이터셋을 반환하지 않습니다. 단일 실행은 기가바이트 규모의 시계열이 될 수 있습니다. nominal_query_channels는 통계와 최대 200개 버킷으로 데시메이션된 최소/최대/평균 트레이스, 그리고 서명된 핸들을 반환합니다. 대량 데이터는 컨텍스트 창에 절대 들어오지 않는 사전 서명된 URL을 통해 나갑니다.

사용자의 자격 증명, 결코 우리의 것이 아닙니다. 서비스 계정이 없습니다. OAuth 흐름은 사용자의 Nominal API 키를 암호화되고 대상(audience)이 바인딩된 1시간짜리 액세스 토큰에 바인딩합니다. 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

테스트

검증 경계: 프로토콜, 인증, 제한, 카탈로그 정책 계층은 완전히 다룹니다. 티어-1 도구에 대한 Nominal 측 요청 인코딩은 생성된 nominal-api Conjure 클라이언트에서 파생되었으며 실제 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 권한 부여 중에 발생합니다: 사용자당 로그인당 약 3회이며, 이후에는 없습니다.

즉, 요청 볼륨은 스토리지 할당량이 아니라 Workers 요청 한도에 의해 제한되며, 배포를 사용할 수 있는 사람 수는 사용 강도가 아니라 일일 새 로그인에 의해 제한됩니다.

첫 번째 구현에서는 그렇지 않았습니다. 속도 제한기는 KV에서 요청을 계산했습니다 — 요청당 읽기 한 번과 쓰기 한 번 — Cloudflare 무료 요금제에서는 하루 약 천 개의 요청 후에 서버가 중단되었을 것입니다. 현재 요금제의 한도를 확인하세요. 하지만 구조는 이렇습니다: 기존 사용자의 과도한 사용은 거의 무료이며, 스토리지에 닿는 것은 온보딩뿐입니다.

/health는 어떤 속도 제한기가 활성 상태인지 보고합니다 (binding vs isolate-fallback). 배포가 조용히 폴백되면 배포 스모크 테스트가 실패합니다.

엔드포인트

라이선스

MIT