skatt-mcp: Instructions file for Claude Code

skatt-mcp

Personlig MCP-server for norske skatteberegninger (2025). Kjører lokalt over stdio — ingen data forlater maskinen. Lar chat-Claude svare med faktiske tall, ikke generelle råd.

---

Status og handoff

Denne prosjektets løpende status, arkitektur-beslutninger, og anbefalte neste steg holdes oppdatert i: STATUS.md (i prosjektroten)

Les den filen først ved start av ny økt.

---

Oppsett og kjøring

npm install
npm run build          # tsc → dist/
npm run dev            # tsx src/server.ts (ingen rebuild)
npm run typecheck      # tsc --noEmit

# Verifiser at serveren svarer etter build (bruk cmd.exe, ikke PowerShell, på Windows):
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node dist/server.js

Claude Desktop — config-fil: macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json. Bruk en absolutt sti til dist/server.js (config-fila ekspanderer ikke ~/miljøvariabler):

{
  "mcpServers": {
    "skatt-mcp": {
      "command": "node",
      "args": ["/Users/<DITT-BRUKERNAVN>/projects/skatt-mcp/dist/server.js"]
    }
  }
}

Claude Code CLI: claude mcp add skatt-mcp -- node "$(pwd)/dist/server.js" (kjør fra prosjektroten).

---

Mappestruktur

skatt-mcp/
├── src/
│   ├── server.ts                    ← MCP-entry, registrerer alle verktøy + stdio-transport
│   ├── tools/                       ← ett verktøy per domene (inntekt, formue, aksjer, ask, fond, bolig, krypto, lovdata, import_nordnet) + felles.ts (delte hjelpere, 2026-07-04)
│   ├── lib/
│   │   ├── fifo.ts                  ← domene-nøytral FIFO-engine (brukt av aksjer + krypto)
│   │   └── csv-parsers/nordnet.ts   ← Nordnet CSV-parser (ren funksjon)
│   └── data/satser/{2025,2026}.json ← skattesatser med _meta-blokk (2026: vedtatt 2025-12-18, FORELØPIG skjermingsrente — forbehold vises i output)
├── data/lovdata-cache/              ← gitignored, lazy-cached lov-XML + paragraf-JSON
├── test-fixtures/nordnet/           ← syntetiske CSV-fixturer + build-fixtures.mjs
└── scripts/                         ← test-runners; snapshot-output gitignored