convez.ai
MCP ServerBusca & PesquisaIntermediário
malkreide

Swiss Courts MCP

malkreide/swiss-courts-mcp

Pesquisa jurisprudência suíça em um único interface MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para acesso integrado a decisões judiciais suíças de todos os níveis: Tribunal Federal, Tribunal Administrativo Federal, Tribunal Penal Federal e 26 cortes cantonais via entscheidsuche.ch. Oferece busca por texto completo, filtros por cantão, período e referências legais, sem necessidade de autenticação.

Instalação

$npx convez-ai malkreide/swiss-courts-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 2 semanas
Versão
v0.5.0
Issues abertas
1
Contribuidores
3

Casos de uso

  • Pesquisa de precedentes judiciais por texto completo
  • Análise de decisões por cantão, tribunal ou período específico
  • Integração com pesquisa legislativa (complemento para fedlex-mcp)
  • Suporte trilíngue para decisões em alemão, francês e italiano

Veredito

Ferramenta especializada e bem implementada para pesquisa jurídica suíça em ecossistema MCP. Cobertura abrangente (federal + 26 cantons) e API sem autenticação a tornam acessível, mas o público é limitado a profissionais e pesquisadores de direito.

README

A tradução para o português deste README ainda está na fila.

Part of the Swiss Public Data MCP Portfolio

🏛️ swiss-courts-mcp

Version License: MIT Python 3.11+ MCP No Auth Required CI

MCP Server for Swiss court decisions — Federal Supreme Court (BGer), Federal Administrative Court (BVGer), Federal Criminal Court (BStGer), and all 26 cantonal courts via entscheidsuche.ch

Deutsche Version


Overview

Access Swiss court decisions from all judicial levels through a single MCP interface. Combines full-text search with structured filters for canton, court level, date range, and law references.

SourceCoverageData
entscheidsuche.chFederal + 26 cantonsCourt decisions since ~2000

Synergy with fedlex-mcp: Legislation (SR) + case law = complete legal research.


Features

  • Full-text search across all Swiss court decisions
  • Multi-stage law reference search with regex parser and Elasticsearch boost scoring
  • Dedicated Federal Supreme Court search with chamber filter
  • Canton and court level filtering
  • Recent decisions feed
  • Court taxonomy listing
  • Decision statistics with aggregations
  • Trilingual support (German, French, Italian)
  • No API key required

Prerequisites

  • Python 3.11 or higher
  • An MCP-compatible client (Claude Desktop, Cursor, Windsurf, etc.)

Installation

pip install swiss-courts-mcp

Or install from source:

git clone https://github.com/malkreide/swiss-courts-mcp.git
cd swiss-courts-mcp
pip install -e ".[dev]"

Quickstart

# Run directly
swiss-courts-mcp

# Or via Python module
python -m swiss_courts_mcp

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "swiss-courts": {
      "command": "python",
      "args": ["-m", "swiss_courts_mcp"]
    }
  }
}

Cloud Deployment (HTTP transport)

The HTTP transport is off by default. The default bind host is 127.0.0.1 (loopback only) — 0.0.0.0 must be opted into explicitly (the Dockerfile does this). Running HTTP without authentication logs a warning; only do so behind an authenticating reverse proxy.

# Local HTTP (loopback), no auth — development only
swiss-courts-mcp --http --port 8000

# Container (binds 0.0.0.0, auth enabled) — see Dockerfile
docker build -t swiss-courts-mcp .
docker run -p 8000:8000 -e MCP_AUTH_SECRET="$(openssl rand -hex 32)" swiss-courts-mcp

Relevant environment variables (see .env.example):

VariableDefaultPurpose
MCP_HOST127.0.0.1Bind host. Set to 0.0.0.0 only in containers.
MCP_PORT8000Bind port.
MCP_ALLOW_PUBLIC_BINDfalseSuppress the 0.0.0.0 warning (containers).
MCP_STATELESS_HTTPtrueStateless HTTP → horizontal scaling without sticky sessions.
MCP_AUTH_ENABLEDfalseEnable bearer-token auth for HTTP.
MCP_AUTH_SECRET—HS256 signing key (dev).
MCP_OAUTH_JWKS_URL—JWKS URL for RS256 validation (production).
MCP_REQUIRED_SCOPES—Comma-separated required scopes.
MCP_CORS_ORIGINS—Comma-separated allowed origins (no wildcard in prod).

Authentication validates the user identity from the JWT sub claim only; see ADR 0001.


MCP Protocol Version

This server pins MCP protocol version 2025-11-25 (constant PROTOCOL_VERSION in server.py). A regression test detects drift against the installed SDK so a protocol bump is a conscious change (version + CHANGELOG + this section). SDK updates land monthly via Dependabot.

Project Phase

Phase 1 — read-only (see ROADMAP.md). All tools are readOnlyHint: true; there are no writing or destructive operations. A move to Phase 2 (write) requires a clean re-audit and the gates listed in the roadmap.


Available Tools

Court Decision Search

ToolDescription
search_court_decisionsFull-text search across all court decisions with canton, court level, and date filters
get_court_decisionRetrieve a single decision by its unique signature
search_bger_decisionsSearch Federal Supreme Court decisions with optional chamber filter
search_by_law_referenceFind decisions citing a specific law article (e.g., "Art. 8 BV")

Court Information

ToolDescription
list_courtsList all indexed courts, optionally filtered by canton
get_recent_decisionsLatest decisions, filterable by canton and court level
get_decision_statisticsStatistics on indexed decisions by canton and year

Tool Annotations

All seven tools share the same hints — they are read-only, idempotent, non-destructive, and reach an external system:

AnnotationValue
readOnlyHinttrue
destructiveHintfalse
idempotentHinttrue
openWorldHinttrue

A rechtsrecherche prompt is also provided (a second MCP primitive alongside tools).

Example Use Cases

Use CaseTool Chain
Research case law on data protectionsearch_court_decisions("Datenschutz")
Find practice on a constitutional rightsearch_by_law_reference("Art. 8 BV")
Latest Federal Supreme Court rulingssearch_bger_decisions("Arbeitsrecht", date_from="2024-01-01")
Combined: Law text + case lawfedlex_search_laws("DSG") then search_by_law_reference("Art. 25 DSG")

→ More use cases by audience →


Architecture

┌─────────────────────────────────────┐
│         MCP Client (LLM)            │
│   Claude / Cursor / Windsurf        │
└──────────────┬──────────────────────┘
               │ MCP Protocol
┌──────────────▼──────────────────────┐
│       swiss-courts-mcp              │
│  7 tools · Pydantic validation      │
│  Elasticsearch query builder        │
└──────────────┬──────────────────────┘
               │ HTTPS (POST/GET)
┌──────────────▼──────────────────────┐
│       entscheidsuche.ch             │
│  Elasticsearch backend              │
│  No authentication required         │
│  Federal + 26 cantonal courts       │
└─────────────────────────────────────┘

Safety & Limits

AspectDetails
AccessRead-only (readOnlyHint: true) — the server cannot modify or delete any data
Personal dataNo personal data — all decisions are public court rulings
Rate limitsBuilt-in per-query caps (max 50 results per search, 50 aggregation buckets)
Timeout30 seconds per API call
Data source authNo API keys required — entscheidsuche.ch is publicly accessible
HTTP transport authOptional bearer-token auth (JWT, sub-claim identity); see ADR 0001
EgressCode-layer allow-list (entscheidsuche.ch only, HTTPS-enforced); see egress policy
Error maskingInternal exceptions are logged server-side only; clients receive friendly messages
SecretsNo secrets in code/logs; .env git-ignored, Gitleaks on PRs; see secret management
LicensesCourt decisions are public domain under Swiss law (BGG Art. 27)
Terms of ServiceSubject to entscheidsuche.ch usage terms — please be kind to the server

Project Structure

swiss-courts-mcp/
├── src/
│   └── swiss_courts_mcp/
│       ├── __init__.py
│       ├── __main__.py
│       ├── server.py            # MCP server, 7 tools + 1 prompt, lifespan, auth wiring
│       ├── api_client.py        # HTTP client, ES query builder, egress allow-list
│       ├── auth.py              # JWT bearer-token verifier (HTTP transport)
│       ├── config.py            # Settings object (env-driven)
│       ├── logging_config.py    # structured logging on stderr
│       └── models.py            # structured response envelope
├── tests/                       # unit (respx-mocked) + live + security tests
├── docs/                        # egress, secret-management, ADRs
├── .github/workflows/           # ci · security (gitleaks) · live · publish
├── Dockerfile                   # hardened container (non-root, 0.0.0.0 only here)
├── ROADMAP.md
├── pyproject.toml · CHANGELOG.md · LICENSE
├── CONTRIBUTING.md · CONTRIBUTING.de.md
├── SECURITY.md · SECURITY.de.md
└── README.md · README.de.md

Note (single-file tools): the 7 tools live in server.py rather than a tools/ package. At this count a single module stays readable; the registry (register_tools) keeps registration declarative. This is a deliberate deviation from the "split when > 5 tools" convention and will be revisited if the tool count grows.


Known Limitations

  • Search is limited to decisions indexed by entscheidsuche.ch (not all decisions are publicly available)
  • Full-text document content is not returned — only metadata, title, and abstract
  • Statistics depend on Elasticsearch aggregation support of the backend
  • The court taxonomy structure from Facetten_alle.json may vary

Testing

Unit tests mock all HTTP with respx; live tests hit the real API and run in a separate nightly workflow (live.yml), never blocking PRs.

# Unit tests (HTTP mocked) — what CI runs
pytest tests/ -v -m "not live"

# Live API tests (real entscheidsuche.ch)
pytest tests/ -v -m live

# Linting
ruff check src/ tests/
ruff format src/ tests/

Changelog

See CHANGELOG.md.


Contributing

See CONTRIBUTING.md.


Security

See SECURITY.md for the security posture and how to report a vulnerability.


License

MIT


Author

Hayal Oezkan · malkreide


Credits & Related Projects

Installation

Run via uv's uvx — no clone or manual install needed. Add to your MCP client config (mcpServers for Claude Desktop, Cursor and Windsurf; use a top-level servers key for VS Code in .vscode/mcp.json):

{
  "mcpServers": {
    "swiss-courts-mcp": {
      "command": "uvx",
      "args": [
        "swiss-courts-mcp"
      ]
    }
  }
}
Ver o original no GitHub

Bom para

Relacionados