Metadata-Version: 2.4
Name: ris-mcp
Version: 0.2.1
Summary: MCP server for Austrian RIS (court decisions + federal law) backed by a local FTS5-indexed SQLite mirror
Author-email: Jonas Hertner <jonashertner@protonmail.ch>
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Requires-Dist: huggingface-hub>=0.24
Requires-Dist: lxml>=5.0
Requires-Dist: mcp>=1.2
Requires-Dist: pydantic>=2.7
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Description-Content-Type: text/markdown

# ris-mcp

> **👉 For end users: see [jonashertner.github.io/ris-mcp](https://jonashertner.github.io/ris-mcp/) for the three-command install.**

Local MCP server for the Austrian Rechtsinformationssystem (RIS) — court decisions and consolidated federal law, queryable from Claude (Code, Desktop, claude.ai).

[![CI](https://github.com/jonashertner/ris-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/jonashertner/ris-mcp/actions/workflows/ci.yml)

## What

`ris-mcp` maintains a locally-mirrored, FTS5-indexed SQLite copy of the full Austrian RIS corpus and exposes it to Claude via MCP. Compare to [`philrox/ris-mcp-ts`](https://github.com/philrox/ris-mcp-ts), which is a thin live-API proxy: local mirror wins on search quality, latency, offline capability, and future citation-graph/reranking work.

## Install (users)

See the [landing page](https://jonashertner.github.io/ris-mcp/).

## Develop (contributors)

```bash
git clone https://github.com/jonashertner/ris-mcp.git
cd ris-mcp
uv venv && uv pip install -e ".[dev]"
.venv/bin/pytest -v
```

Run the MCP server locally:

```bash
.venv/bin/ris-mcp serve
```

Kick off a full backfill (2–3 days):

```bash
.venv/bin/ris-ingest --full
```

Emit coverage stats:

```bash
.venv/bin/ris-ingest coverage --out docs/stats.json
```

## Licenses

- Code: MIT
- Data: CC0-1.0 (amtliches Werk per § 7 öUrhG)

## Credits

- [ximex/ris-bka](https://github.com/ximex/ris-bka) — RIS OGD documentation
- [philrox/ris-mcp-ts](https://github.com/philrox/ris-mcp-ts) — different design, same goal
- [PhilippTh/ris-API-wrapper](https://github.com/PhilippTh/ris-API-wrapper) — Python wrapper precedent
- [opencaselaw.ch](https://opencaselaw.ch) — architectural inspiration
