Skip to content
Back to search

mcp-server-kotlin-template

Mal for MCP-server i Kotlin bak fleet-gateway (Ktor, 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-kotlin-template/badge.svg)](/listings/navikt--mcp-server-kotlin-template)

HTML

<a href="/listings/navikt--mcp-server-kotlin-template"><img src="/api/listings/navikt--mcp-server-kotlin-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 · 45 lines
  1. # MCP-server i Kotlin (referanse)
  2. Liten MCP-server med Ktor og den offisielle [MCP Kotlin SDK](https://github.com/modelcontextprotocol/kotlin-sdk) (0.16.0). Den viser bare det Nav-spesifikke. Semantikken er kopiert fra Go-referansen [`apps/mcp-kodeverk`](https://github.com/navikt/copilot/tree/main/apps/mcp-kodeverk) (`auth.go` og testene). Retningslinjene: [#2490](https://github.com/navikt/copilot/issues/2490).
  3. ## Hva den viser
  4. | Krav | Hvor |
  5. |---|---|
  6. | Innkommende token valideres med Texas-introspeksjon. `azp` må være fleet-gateways klient-ID (fra `AZURE_APP_PRE_AUTHORIZED_APPS`), `NAVident` må finnes, app-tokens (`idtyp=app` eller rollen `access_as_application`) avvises. Mangler konfigurasjon, svarer serveren 503. | `Auth.kt` |
  7. | OBO via Texas til nedstrøms API. Innkommende token videresendes aldri. | `Texas.exchange`, `Server.kt` |
  8. | Tak på forespørsel (64 KiB, 413), nedstrøms svar (1 MiB, feil) og resultat til modellen (32 KiB, avkortet med hint) | `Server.kt` |
  9. | Ett lesende verktøy, `kodeverk_list`, med alle fire annotasjoner (`readOnlyHint: true`). Annotasjoner er hint. Serveren håndhever lesing ved å bare kalle GET. | `Server.kt` |
  10. | Metrikker per verktøy (`mcp_tool_calls_total`, `mcp_tool_errors_total`, `mcp_tool_duration_seconds_sum`) på `/metrics`. Label er bare registrerte verktøynavn. | `Metrics.kt` |
  11. | Test | `src/test/.../ServerTest.kt` |
  12. | Nais-skisse med `accessPolicy` inn fra fleet-gateway | `.nais/app.yaml` |
  13. Serveren er tilstandsløs (`mcpStatelessStreamableHttp`): ett `Server`-objekt per forespørsel, så brukerens token ligger i closure og ikke i en sesjon.
  14. ## Kjøre lokalt
  15. Krever JDK 21 (bruk ikke nyere JDK enn Gradle 8.14 støtter). Wrapperen henter Gradle 8.14.7.
  16. ```sh
  17. cd examples/mcp-server-kotlin
  18. ./gradlew test
  19. ```
  20. CI bygger ikke dette prosjektet. Kjør testene selv før du endrer noe.
  21. ## Kjente forenklinger
  22. - Forespørsler uten `Content-Length` (chunked) avvises med 411, slik at størrelsestaket ikke kan omgås. Gatewayen sender `Content-Length`.
  23. - Metrikkene er en enkel tekstutskrift uten bibliotek. Bytt til Micrometer hvis du trenger histogram.
  24. - Ingen rate limit, `Mcp-*`-hodesjekk (`-32020`) eller `outputSchema`. Se Go-referansen.
  25. - Tokenvalidering kaller Texas på hver forespørsel, uten cache.
  26. ## Bruk malen
  27. 1. Trykk **Use this template** øverst på siden i GitHub og velg **Create a new repository**. Du får en ny kopi uten historikk.
  28. 2. Bytt navn, team og URL-er i `.nais/app.yaml`, og sett opp tilgangen din som beskrevet over.
  29. 3. Bytt ut verktøyet `list_codes`/`kodeverk_list` med dine egne. Behold autentiseringen, grensene og testene.
  30. 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.
  31. 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.