Luxembourg Law MCP

Production-grade Luxembourg legislation MCP server with:

stdio transport for local MCP clients.
Streamable HTTP transport for Vercel/serverless deployment.
Golden contract tests and nightly drift detection anchors.
Automated update checks against Legilux.

Requirements

Node.js >=18
npm

Install

npm install

Build And Run

npm run build
npm start

Dev mode:

npm run dev

Database

Build the SQLite database from data/seed/*.json:

npm run build:db

Ingest from Legilux:

# Full discovery + ingestion
npm run ingest

# Only selected laws
npm run ingest -- --ids loi-1799-07-04-n1,loi-2002-08-02-n2

# Overwrite existing seed files
npm run ingest -- --ids loi-1799-07-04-n1 --force

Override DB path:

export LUXEMBOURG_LAW_DB_PATH=/absolute/path/to/database.db

Testing

Run full test suite:

npm test

Run golden contract tests:

npm run test:contract

Nightly-mode contract checks (includes network assertions):

CONTRACT_MODE=nightly npm run test:contract

Coverage:

npm run test:coverage

Drift Detection

Run upstream drift checks for configured anchors:

npm run drift:detect

Anchors are configured in fixtures/golden-hashes.json.

Update Checks

Compare local data with Legilux:

npm run check-updates

Machine-readable output:

npm run check-updates -- --json --output update-summary.json

Vercel Deployment

API handlers:

api/mcp.ts for MCP streamable HTTP (/mcp)
api/health.ts for health/version (/health, /version)

vercel.json config includes rewrites and packaged DB file.

GitHub Actions deployment workflow

The workflow .github/workflows/vercel-deploy.yml supports:

PR preview deploys
Production deploys on main

Required repository secrets:

VERCEL_TOKEN
VERCEL_ORG_ID
VERCEL_PROJECT_ID

GitHub Actions

ci.yml: build, tests, contract tests, coverage, typecheck.
check-updates.yml: daily freshness checks + issue management + optional auto-update.
drift-detect.yml: nightly drift checks with issue creation on mismatch.
vercel-deploy.yml: preview and production deployment to Vercel.

API Endpoints

GET /health: health payload
GET /version: version/capability payload
POST /mcp: streamable MCP endpoint

License

Apache-2.0

luxembourg-law-mcp

Quick Install