Skip to content
Back to search

mcp-server-typescript-template

Mal for MCP-server i TypeScript bak fleet-gateway (Texas, Nais)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/navikt--mcp-server-typescript-template/badge.svg)](/listings/navikt--mcp-server-typescript-template)

HTML

<a href="/listings/navikt--mcp-server-typescript-template"><img src="/api/listings/navikt--mcp-server-typescript-template/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 57 lines
  1. # MCP-server i TypeScript (referanse)
  2. Liten referanse for den Nav-spesifikke delen av en MCP-server, med det offisielle SDK-et
  3. [`@modelcontextprotocol/server`](https://github.com/modelcontextprotocol/typescript-sdk) v2
  4. (MCP 2026-07-28). Semantikken er hentet fra Go-referansen `apps/mcp-kodeverk` (`auth.go`).
  5. Alt som ikke er Nav-spesifikt overlater vi til SDK-et.
  6. ## Hva eksempelet viser
  7. | Krav | Hvor |
  8. | --- | --- |
  9. | Texas-introspeksjon: `azp` er fleet-gateways klient-ID (fra `AZURE_APP_PRE_AUTHORIZED_APPS`), `NAVident` kreves, app-tokens avvises (`idtyp=app` eller rollen `access_as_application`). Mangler konfigurasjon, svarer serveren 503. | `src/auth.ts` (`validateToken`) |
  10. | Texas OBO til nedstrøms API. Det innkommende tokenet sendes aldri videre. | `src/auth.ts` (`exchangeToken`) |
  11. | Tak på forespørsel (1 MiB, svarer 413) og på nedstrømssvar og verktøyutdata (32 KiB). | `src/server.ts` |
  12. | Ett skrivebeskyttet verktøy, `list_codes`, med `readOnlyHint: true`. | `src/server.ts` |
  13. | Målinger per verktøy (`mcp_tool_calls_total`, `mcp_tool_duration_seconds_sum`) på `/metrics`. Etiketter: verktøy og utfall, så kardinaliteten er fast. | `src/server.ts` (`Metrics`) |
  14. | Test, inkludert at hver auth-regel avviser. | `src/server.test.ts` |
  15. | Nais-skisse med `accessPolicy` inn fra fleet-gateway. | `.nais/app.yaml` |
  16. `readOnlyHint` er et hint til klienten, ikke en sikkerhetsgrense. Serveren skriver ikke uansett.
  17. ## Kjør lokalt
  18. Krever Node 22 eller nyere og pnpm.
  19. ```sh
  20. pnpm install
  21. pnpm check # typesjekk
  22. pnpm test # vitest, uten nettverk: Texas og nedstrøms er falske
  23. pnpm start # trenger Texas-miljøvariabler fra Nais
  24. ```
  25. CI bygger ikke dette eksempelet. Kjør `pnpm check` og `pnpm test` selv når du endrer det.
  26. ## Miljøvariabler
  27. | Variabel | Beskrivelse |
  28. | --- | --- |
  29. | `NAIS_TOKEN_INTROSPECTION_ENDPOINT`, `NAIS_TOKEN_EXCHANGE_ENDPOINT` | Texas (injiseres av Nais) |
  30. | `AZURE_APP_PRE_AUTHORIZED_APPS`, `NAIS_CLUSTER_NAME` | Gir fleet-gateways klient-ID. Mangler den, avvises alle kall. |
  31. | `KODEVERK_URL`, `KODEVERK_SCOPE` | Nedstrøms API og OBO-scope |
  32. | `PORT` | Standard 8080 |
  33. ## Kjente begrensninger
  34. - Ingen rate limit og ingen cache. Se retningslinjene i navikt/copilot#2490.
  35. - Eksempelet viser ikke `outputSchema`/`structuredContent`, paginering eller skriveverktøy.
  36. ## Bruk malen
  37. 1. Trykk **Use this template** øverst på siden i GitHub og velg **Create a new repository**. Du får en ny kopi uten historikk.
  38. 2. Bytt navn, team og URL-er i `.nais/app.yaml`, og sett opp tilgangen din som beskrevet over.
  39. 3. Bytt ut verktøyet `list_codes`/`kodeverk_list` med dine egne. Behold autentiseringen, grensene og testene.
  40. Retningslinjene for MCP-servere i Nav: [navikt/copilot#2490](https://github.com/navikt/copilot/issues/2490). Siden på ki-utvikling.nav.no er ikke publisert ennå, så lenken byttes når den finnes.
  41. Samsvarssjekk for MCP-servere bak fleet-gateway: [`cli/mcp-compliance`](https://github.com/navikt/copilot/tree/main/cli/mcp-compliance) i navikt/copilot.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.