@ansvar/slovenian-law-mcp

v1.1.1

Published

12 days ago

Production-grade Slovenian legal research MCP server with comprehensive statute coverage and EU law cross-references

0High
0Medium
0Low

ansvar

mcp model-context-protocol ai claude slovenian-law slovenia legal compliance pisrs pis sodnapraksa ansvar

Slovenian Law MCP

Production-grade Model Context Protocol server for Slovenian legal research.

It provides structured access to:

Slovenian statutes and regulations (PIS / pisrs.si)
Slovenian case law metadata (sodnapraksa.si)
EU legal cross-references (EUR-Lex metadata)
Parliamentary preparatory works (Drzavni zbor)

Package: @ansvar/slovenian-law-mcp
MCP name: eu.ansvar/slovenian-law-mcp

Features

14 MCP tools for legal search, citation handling, temporal retrieval, and EU-compliance checks
SQLite + FTS5 query engine optimized for article-level lookup
Seed-based database build included in repository
Optional paid enrichment pipeline (case law ingestion, cross-references, EU import)
Stdio transport (CLI/MCP clients) and streamable HTTP transport (Vercel API)

Quick Start

Use Remotely (No Install Needed)

Connect directly to the hosted version — zero dependencies, nothing to install.

Endpoint: https://slovenian-law-mcp.vercel.app/mcp

| Client | How to Connect | |--------|---------------| | Claude.ai | Settings > Connectors > Add Integration > paste URL | | Claude Code | claude mcp add slovenian-law --transport http https://slovenian-law-mcp.vercel.app/mcp | | Claude Desktop | Add to config (see below) | | GitHub Copilot | Add to VS Code settings (see below) |

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "slovenian-law": {
      "type": "url",
      "url": "https://slovenian-law-mcp.vercel.app/mcp"
    }
  }
}

GitHub Copilot — add to VS Code settings.json:

{
  "github.copilot.chat.mcp.servers": {
    "slovenian-law": {
      "type": "http",
      "url": "https://slovenian-law-mcp.vercel.app/mcp"
    }
  }
}

Use Locally (npm)

npx @ansvar/slovenian-law-mcp

Claude Desktop — add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "slovenian-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/slovenian-law-mcp"]
    }
  }
}

Cursor / VS Code:

{
  "mcp.servers": {
    "slovenian-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/slovenian-law-mcp"]
    }
  }
}

Local Development

Prerequisites:

Node.js 18+ (Node 20+ recommended)
npm

Setup:

npm install
npm run verify:seeds
npm run build
npm test

Run server locally:

npm run dev

Seeded Database

The repository ships with seed files in data/seed/*.json.

Build seed database: npm run build:db
Audit seed quality: npm run audit:seeds
Full seed verification (audit + rebuild): npm run verify:seeds

The prepublishOnly hook enforces release verification:

npm run verify:release (seed audit, seed DB build, TypeScript build, tests)

Default runtime DB path:

data/database.db

Override with:

SLOVENIAN_LAW_DB_PATH=/absolute/path/to/database.db

Example Prompts

Once connected, try asking your AI assistant:

"What does Article 14 of ZVOP-2 say about data processing?"
"Search for Slovenian laws about environmental protection (varstvo okolja)"
"Which EU directives does ZVOP-2 implement?"
"Is the Criminal Code (KZ-1) currently in force?"
"Show me court decisions about personal data (osebni podatki)"
"Build a legal stance on employee dismissal (odpoved pogodbe o zaposlitvi)"
"Validate the citation: 1. clen ZKP"
"What are the data sources used by this legal database?"

MCP Tools

search_legislation
get_provision
search_case_law
get_preparatory_works
validate_citation
build_legal_stance
format_citation
check_currency
get_eu_basis
get_slovenian_implementations
search_eu_implementations
get_provision_eu_basis
validate_eu_compliance
get_provision_at_date

HTTP Deployment (Vercel)

This repository includes:

api/mcp.ts (streamable HTTP MCP endpoint)
api/health.ts (health endpoint)
vercel.json rewrites:
- /mcp -> /api/mcp
- /health -> /api/health

Docker

Build image (requires prebuilt DB):

npm run build:db
docker build -t slovenian-law-mcp .

Data Sources

PIS (Pravno-informacijski sistem RS): https://pisrs.si
Sodna praksa portal: https://www.sodnapraksa.si
EUR-Lex: https://eur-lex.europa.eu
Drzavni zbor legislative materials: https://www.dz-rs.si

CI/CD & Security

This repository uses GitHub Actions for automated quality and security enforcement:

| Workflow | Schedule | Purpose | |----------|----------|---------| | CI | Push / PR | Build, test (Node 18/20/22), type check, coverage | | CodeQL | Push / PR / Weekly | Semantic code analysis (security-extended queries) | | Trivy | Push / PR / Daily | Dependency vulnerability scanning (SARIF) | | Semgrep | Push / PR | SAST — OWASP Top 10, secrets, JS/TS rules | | Gitleaks | Push / PR | Secret scanning across full git history | | OSSF Scorecard | Push / Weekly | Repository security hygiene scoring | | Socket Security | Push / PR | Supply chain attack detection | | Docker Security | Push / PR / Daily | Container image scanning + SBOM (CycloneDX, SPDX) | | Data Freshness | Daily | PIS portal amendment check, auto-issue creation | | Publish | Tag v* | npm publish (with provenance) + MCP Registry | | MCPB Bundle | Tag v* | MCPB distribution bundle |

Release Checklist

npm run verify:release
npm pack --dry-run

Important Disclaimers

Legal Advice

THIS TOOL IS NOT LEGAL ADVICE
Statute text is sourced from official PIS/pisrs.si publications. However:
This is a research tool, not a substitute for professional legal counsel
Court case coverage is limited -- do not rely solely on this for case law research
Verify critical citations against primary sources for court filings
EU cross-references are extracted from Slovenian statute text, not EUR-Lex full text

Client Confidentiality

Queries go through the Claude API. For privileged or confidential matters, use on-premise deployment. Lawyers should consider Odvetniška zbornica Slovenije (Slovenian Bar Association) confidentiality obligations when using cloud-based AI tools.

Related Projects: Complete Compliance Suite

This server is part of Ansvar's Compliance Suite -- MCP servers that work together for end-to-end compliance coverage:

@ansvar/eu-regulations-mcp

Query 49 EU regulations directly from Claude -- GDPR, AI Act, DORA, NIS2, MiFID II, eIDAS, and more. Full regulatory text with article-level search. npx @ansvar/eu-regulations-mcp