Back to search
mcp-server-kotlin-template
MCP serverGitHub
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
Markdown
[](/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
- # MCP-server i Kotlin (referanse)
- 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).
- ## Hva den viser
- | Krav | Hvor |
- |---|---|
- | 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` |
- | OBO via Texas til nedstrøms API. Innkommende token videresendes aldri. | `Texas.exchange`, `Server.kt` |
- | Tak på forespørsel (64 KiB, 413), nedstrøms svar (1 MiB, feil) og resultat til modellen (32 KiB, avkortet med hint) | `Server.kt` |
- | 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` |
- | 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` |
- | Test | `src/test/.../ServerTest.kt` |
- | Nais-skisse med `accessPolicy` inn fra fleet-gateway | `.nais/app.yaml` |
- Serveren er tilstandsløs (`mcpStatelessStreamableHttp`): ett `Server`-objekt per forespørsel, så brukerens token ligger i closure og ikke i en sesjon.
- ## Kjøre lokalt
- Krever JDK 21 (bruk ikke nyere JDK enn Gradle 8.14 støtter). Wrapperen henter Gradle 8.14.7.
- ```sh
- cd examples/mcp-server-kotlin
- ./gradlew test
- ```
- CI bygger ikke dette prosjektet. Kjør testene selv før du endrer noe.
- ## Kjente forenklinger
- - Forespørsler uten `Content-Length` (chunked) avvises med 411, slik at størrelsestaket ikke kan omgås. Gatewayen sender `Content-Length`.
- - Metrikkene er en enkel tekstutskrift uten bibliotek. Bytt til Micrometer hvis du trenger histogram.
- - Ingen rate limit, `Mcp-*`-hodesjekk (`-32020`) eller `outputSchema`. Se Go-referansen.
- - Tokenvalidering kaller Texas på hver forespørsel, uten cache.
- ## Bruk malen
- 1. Trykk **Use this template** øverst på siden i GitHub og velg **Create a new repository**. Du får en ny kopi uten historikk.
- 2. Bytt navn, team og URL-er i `.nais/app.yaml`, og sett opp tilgangen din som beskrevet over.
- 3. Bytt ut verktøyet `list_codes`/`kodeverk_list` med dine egne. Behold autentiseringen, grensene og testene.
- 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.
- 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 inFree to use. If it’s helped, pass it on.