Paragraf

MCP-server som gir AI-assistenter tilgang til alle norske lover og forskrifter via Model Context Protocol.

92 000+ paragrafer fra 773 lover og 3 673 forskrifter — gratis under NLOD 2.0-lisensen.

Hvorfor

LLM-er hallusinerer lovtekst. Denne serveren gir dem presis, oppdatert norsk rett som verktøykall i stedet for gjetting.

Bruker:  "Kan utleier si meg opp?"
AI:      sok("oppsigelse leie") → 4 treff
         lov("husleieloven", "9-7") → full tekst
Svar:    "Etter husleieloven § 9-7 skal oppsigelse fra utleier
          være skriftlig og begrunnet..."

Funksjoner

Funksjon	Beskrivelse
Lovoppslag	Slå opp enhver lov/forskrift med kortnavn eller full ID
Fulltekstsøk (FTS)	PostgreSQL tsvector med norsk stemming, ~6ms
Semantisk søk	Hybrid vektor+FTS med Gemini embeddings for naturlig språk
Batch-henting	Hent flere paragrafer i ett kall (~80% raskere)
Innholdsfortegnelse	Hierarkisk oversikt (Del → Kapittel → §) med token-estimat
Alias-oppløsning	`aml`, `avhl`, `pbl` + fuzzy matching for stavefeil
OR-fallback	AND-søk som automatisk faller tilbake til OR ved 0 treff

Arkitektur

┌──────────────────┐     HTTPS/JSON-RPC      ┌──────────────────────────┐
│  Claude.ai       │ ──────────────────────►  │  Flask Backend           │
│  Copilot Studio  │                          │                          │
│  Gemini AI       │                          │  ┌────────────────────┐  │
│  (MCP-klient)    │ ◄──────────────────────  │  │  MCP Server        │  │
└──────────────────┘                          │  │  (JSON-RPC router) │  │
                                              │  └────────┬───────────┘  │
                                              │           │              │
                                              │  ┌────────▼───────────┐  │
                                              │  │  LovdataService    │  │
                                              │  │  (alias, validering│  │
                                              │  │   formatering)     │  │
                                              │  └────────┬───────────┘  │
                                              │           │              │
                                              └───────────┼──────────────┘
                                                          │
                                        ┌─────────────────┴──────────────────┐
                                        │                                    │
                                        ▼                                    ▼
                              ┌───────────────────┐              ┌───────────────────┐
                              │  Supabase         │              │  Lovdata API       │
                              │  PostgreSQL       │              │  api.lovdata.no    │
                              │                   │              │                    │
                              │  • FTS (GIN)      │              │  Bulk tar.bz2      │
                              │  • pgvector       │              │  (kun ved sync)    │
                              │  • pg_trgm        │              │                    │
                              └───────────────────┘              └───────────────────┘

Bruk

Hosted (ingen installasjon)

MCP-serveren er fritt tilgjengelig — ingen registrering eller API-nøkkel kreves.

Claude.ai:

Gå til Settings → Connectors → Add custom connector
URL: https://api.paragraf.dev/mcp/
Ferdig

Eneste begrensning er 120 req/min per IP (burst-beskyttelse).

Lokal installasjon

pip install paragraf            # Minimal (SQLite backend)
pip install paragraf[supabase]  # Med Supabase PostgreSQL
pip install paragraf[all]       # Alt (Supabase + vektorsøk + HTTP)

Eller fra kildekode:

git clone https://github.com/khjohns/paragraf.git
cd paragraf
pip install -e ".[all]"

Konfigurasjon

# .env
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=eyJ...

# Valgfritt: for semantisk søk
GEMINI_API_KEY=AIza...

Uten Supabase brukes SQLite som lokal fallback.

Synkroniser lovdata

paragraf sync                   # Inkrementell sync (sjekker last-modified)
paragraf sync --force           # Tving full re-sync

Start serveren

paragraf serve                  # stdio MCP (for Claude Desktop, Cursor)
paragraf serve --http           # HTTP MCP (for claude.ai connector)
paragraf serve --http --port 8000

MCP-verktøy

Verktøy	Beskrivelse	Eksempel
`lov`	Slå opp lov	`lov("aml", "14-9")`
`forskrift`	Slå opp forskrift	`forskrift("foa", "25-2")`
`sok`	Fulltekstsøk	`sok("mangel bolig")`
`semantisk_sok`	AI-drevet søk	`semantisk_sok("skjulte feil i boligen")`
`hent_flere`	Batch-henting	`hent_flere("aml", ["14-9", "15-6"])`
`sjekk_storrelse`	Token-estimat	`sjekk_storrelse("skatteloven", "5-1")`
`liste`	Vis aliaser	`liste()`
`status`	Sync-status	`status()`
`sync`	Synkroniser	`sync(force=True)`

Alias-oppløsning

Fire nivåer for å finne riktig lov:

Nivå	Eksempel
1. Hardkodet alias	`aml` → `LOV-2005-06-17-62`
2. Database (short_title)	`husleieloven` → `lov/1999-03-26-17`
3. Fuzzy (pg_trgm)	`husleielova` → husleieloven (similarity: 0.59)
4. Direkte ID	`lov/1999-03-26-17` → brukes som-er

Søkesyntaks (FTS)

Syntaks	Eksempel	Betydning
Standard	`mangel bolig`	AND (begge ord)
OR	`miljø OR klima`	Minst ett ord
Frase	`"vesentlig mislighold"`	Eksakt frase
Ekskludering	`mangel -bil`	mangel, ikke bil

AND-søk som gir 0 treff faller automatisk tilbake til OR.

Mappestruktur

src/paragraf/
├── __init__.py              # Pakke-eksport (MCPServer, LovdataService)
├── server.py                # MCP JSON-RPC server (9 verktøy)
├── service.py               # Forretningslogikk, aliaser, validering
├── supabase_backend.py      # Supabase PostgreSQL backend
├── sqlite_backend.py        # SQLite fallback + sync fra API
├── structure_parser.py      # XML → hierarkisk struktur
├── vector_search.py         # Hybrid vektor+FTS søk
├── cli.py                   # CLI (serve, sync, status)
├── web.py                   # Flask blueprint factory
└── _supabase_utils.py       # Retry/backoff, feilhåndtering

web/
└── app.py                   # Standalone Flask-app (hosted deploy)

site/                        # Landing page (paragraf.dev, GitHub Pages)

scripts/
└── embed.py                 # Generer embeddings for vektorsøk

migrations/
└── 001_complete_schema.sql  # Supabase-skjema (tabeller, funksjoner, indekser)

docs/
├── ADR-001.md               # Arkitekturbeslutninger
└── ADR-002.md               # Tilgangsmodell og rate limiting

API-endepunkter

Metode	Sti	Beskrivelse
`POST`	`/mcp/`	MCP JSON-RPC (hovedendepunkt)
`HEAD`	`/mcp/`	Protokollversjon-sjekk
`GET`	`/mcp/`	SSE-stream (bakoverkompatibilitet)
`GET`	`/mcp/health`	Helsesjekk
`GET`	`/mcp/info`	Serverinfo og verktøyliste

Ytelse

Metrikk	Verdi
FTS-søk (warm cache)	~6ms
FTS-søk (cold cache)	~600ms
Lovoppslag	~50-200ms
Batch 3 paragrafer	~100ms (vs 491ms separat)
Database-størrelse	~160MB tabell + 42MB TOAST + 37MB GIN
Vektorsøk (hybrid)	~200-500ms (inkl. embedding)

Datamodell

Tabeller

lovdata_documents (4 446 rader)
├── dok_id TEXT UNIQUE        "lov/2005-05-20-28"
├── title TEXT                "Lov om arbeidsmiljø..."
├── short_title TEXT          "Arbeidsmiljøloven"
├── doc_type TEXT             "lov" | "forskrift"
├── ministry TEXT             "Arbeids- og inkluderingsdepartementet"
└── search_vector TSVECTOR

lovdata_sections (92 164 rader)
├── dok_id + section_id       UNIQUE
├── content TEXT               Paragraftekst
├── search_vector TSVECTOR     Norsk stemming
├── embedding VECTOR(1536)     Gemini embedding (100% dekning)
├── char_count INTEGER         GENERATED ALWAYS
└── structure_id UUID FK       → lovdata_structure

lovdata_structure (14 798 rader)
├── structure_type TEXT        "del" | "kapittel" | "avsnitt" | "vedlegg"
├── title TEXT                 "Kapittel 2. Arbeidsgivers plikter"
├── parent_id UUID FK          Hierarkisk (self-ref)
└── sort_order INTEGER

Indekser

GIN på search_vector — fulltekstsøk
GIN på short_title med pg_trgm — fuzzy matching
IVFFlat på embedding (lists=100) — vektorsøk
B-tree på dok_id, section_id, structure_id — oppslag

Sikkerhet

Ingen brukerdata lagres — åpent, authless design
Ingen registrering — MCP-URL er fritt tilgjengelig
Rate limiting — 120 req/min per IP (burst-beskyttelse via Flask-Limiter)
Parameteriserte queries — ingen SQL injection
Input-validering på alle MCP-verktøy
NLOD 2.0-lisens — alle data er offentlige

Testet mot

Angrep	Resultat
SQL injection (`'; DROP TABLE--`)	Blokkert
Path traversal (`../../../etc/passwd`)	Ingen filsystem-tilgang
XSS (`<script>alert('xss')</script>`)	Behandlet som tekst

Begrensninger

Inkludert (gratis via Lovdata Public API)

Gjeldende lover (773+)
Sentrale forskrifter (3 673+)
Lokale forskrifter, delegeringer, instrukser

IKKE inkludert

Rettsavgjørelser (Høyesterett, lagmannsrett) — krever Lovdata Pro
Forarbeider (NOU, Prop., Ot.prp.) — krever Lovdata Pro
Juridiske artikler

Miljøvariabler

Variabel	Påkrevd	Beskrivelse
`SUPABASE_URL`	Ja*	Supabase prosjekt-URL
`SUPABASE_SERVICE_ROLE_KEY`	Ja*	Service role nøkkel
`GEMINI_API_KEY`	Nei	For semantisk søk
`LOVDATA_CACHE_DIR`	Nei	SQLite cache-sti (default: `/tmp/lovdata-cache`)

* SQLite brukes som fallback uten Supabase.

Utvikling

# Installer fra kildekode
pip install -e ".[all,dev]"

# Generer embeddings (krever GEMINI_API_KEY)
python scripts/embed.py --dry-run    # Sjekk kostnad
python scripts/embed.py              # Kjør

# Linting (pre-commit hook kjører automatisk)
ruff check src/ scripts/
ruff format src/ scripts/

# Helsesjekk
curl http://localhost:8000/mcp/health

# Test MCP-kall
curl -X POST http://localhost:8000/mcp/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "lov",
      "arguments": {"lov_id": "aml", "paragraf": "14-9"}
    }
  }'

Teknologi

Komponent	Teknologi
Server	Flask + Python 3.11
Database	Supabase PostgreSQL (SQLite fallback)
Fulltekstsøk	PostgreSQL tsvector + GIN
Vektorsøk	pgvector IVFFlat + Gemini embeddings
Fuzzy matching	pg_trgm
Protokoll	MCP 2025-06-18, Streamable HTTP
Datakilde	Lovdata Public API (NLOD 2.0)
Landing page	GitHub Pages (paragraf.dev)

Lisens

Inneholder data under Norsk lisens for offentlige data (NLOD 2.0) tilgjengeliggjort av Lovdata.

Dokumentasjon

ADR-001: Arkitekturbeslutninger — datamodell, søk, sync, MCP-verktøy
ADR-002: Tilgangsmodell — åpen tilgang og rate limiting
MCP Specification
Lovdata Public API

Name		Name	Last commit message	Last commit date
Latest commit History 83 Commits
.claude		.claude
.github/workflows		.github/workflows
docs		docs
migrations		migrations
scripts		scripts
site		site
src/paragraf		src/paragraf
tests		tests
web		web
.env.example		.env.example
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
pyproject.toml		pyproject.toml

Folders and files

Latest commit

History

Repository files navigation

Paragraf

Hvorfor

Funksjoner

Arkitektur

Bruk

Hosted (ingen installasjon)

Lokal installasjon

Konfigurasjon

Synkroniser lovdata

Start serveren

MCP-verktøy

Alias-oppløsning

Søkesyntaks (FTS)

Mappestruktur

API-endepunkter

Ytelse

Datamodell

Tabeller

Indekser

Sikkerhet

Testet mot

Begrensninger

Inkludert (gratis via Lovdata Public API)

IKKE inkludert

Miljøvariabler

Utvikling

Teknologi

Lisens

Dokumentasjon

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages