Law Office SQLite MCP Server

SQLite MCP-Server für Anwaltskanzleien

Eine Model Context Protocol (MCP)-Serverimplementierung für die Datenbankverwaltung von Anwaltskanzleien, spezialisiert auf Kundendatensätze, Fallablage, Zeiterfassung und Rechnungsverwaltung.

Überblick

Dieser Server bietet eine spezielle Datenbankschnittstelle für Anwaltskanzleien, die es KI-Assistenten (wie Claude) ermöglicht, mit wichtigen Praxisdaten zu interagieren, um:

• Verwalten Sie Kunden- und Falldatensätze.
• Verfolgen Sie Falldateieinträge (Dokumente, Kommunikation, Notizen) mit wörtlichen Inhaltsregeln.
• Protokollieren Sie die abrechenbare Zeit mit detaillierter Begründung, Vertrauensstufen und Links zu Fallaktivitäten.
• Erstellen, validieren und verwalten Sie Kundenrechnungen gemäß definierten Arbeitsabläufen.
• Setzen Sie Geschäftsregeln für eine ordnungsgemäße Abrechnung durch, einschließlich der strikten Vermeidung von Zeitkonflikten.
• Erstellen Sie formatierte Berichte wie wöchentliche Arbeitszeitnachweise.
• Verfolgen Sie Termine und Kalenderereignisse.

Merkmale

Kerndatenbankvorgänge

• Standard-SQL-Operationen (SELECT, INSERT, UPDATE, DELETE) über spezielle Tools ( read_query , write_query ).
• Tabellenverwaltung ( create_table ) und Schemainformationen ( describe_table , list_tables ).
• Transaktionen mit mehreren Anweisungen und Stapelverarbeitungsvorgänge über das Tool execute_script (mit Semikolon-Trennung).

Spezialisierte Rechtsinstrumente (Highlights)

• record_case_entry : Fügt Falldateien Dokumente/E-Mails mit Metadaten hinzu.
• record_billable_time : Protokolliert die Zeit mit der erforderlichen Begründung, den Vertrauensstufen und der Begründung.
• get_unbilled_time : Verfolgt nicht in Rechnung gestellte Arbeiten nach Kunde oder Angelegenheit.
• create_invoice , add_billing_to_invoice , check_invoice_validity , submit_invoice : Verwalten Sie den Rechnungslebenszyklus.
• generate_weekly_timesheet : Erstellt formatierte Stundenzettel zur Überprüfung. (Hinweis: update_case_entry_synopsis und calculate_billing_hours sind in der Spezifikation beschrieben, aber noch nicht als eigenständige Tools implementiert.)

Datenbankschema und -logik

• Tabellen für Mandanten, Angelegenheiten, Fallakteneinträge, Abrechnungseinträge, Rechnungen, Rechnungspositionen und Kalenderereignisse (siehe Spezifikationsdokument).
• Umfassende Unterstützung des Abrechnungs- und Rechnungsworkflows.
• Automatische Verwaltung der Zeitstempel „ created und last_modified .
• Strikte Konfliktvermeidung: Datenbankauslöser (VOR INSERT/UPDATE bei billing_entries ) lehnen automatisch Versuche ab, Zeiteinträge zu speichern, die sich mit zuvor zugesagter Zeit auf eingereichten Rechnungen überschneiden.

Dynamische Ressourcen

• Zusammenfassungen für alle Fälle ( case://summary/all ) oder bestimmte Angelegenheiten ( case://summary/{matter_id} ).
• Abrechnungsberichte für alle Einträge ( billing://report/all ), bestimmte Angelegenheiten ( billing://report/{matter_id} ) oder Kunden ( billing://client/{client_id} ).
• Detaillierte Rechnungsansichten ( invoice://detail/{invoice_id} ).
• Listen mit bevorstehenden Fristen ( deadline://list/{matter_id} ).

Geführte Eingabeaufforderungen

• Strukturierte Eingabeaufforderungen zum Starten gängiger Arbeitsabläufe wie dem Erstellen neuer Fälle ( new-matter ), der Abrechnungsanalyse ( billing-analysis ), der Rechnungserstellung ( create-invoice ) und dem Hinzufügen von Dokumenten ( document-intake ). (Hinweis: case-timeline ist in der Spezifikation beschrieben, aber noch nicht implementiert.)

Installation

(Voraussetzungen: Python 3.10+, uv, SQLite3, Git)

1. Klonen Sie das Repository:
   git clone <repository_url> # Replace with your repo URL cd mcp-law-office-db # Or your repository directory name
2. Erstellen und aktivieren Sie eine virtuelle Umgebung:
   # Replace python3.11 with your specific version if needed python3.11 -m venv .venv source .venv/bin/activate # On Windows use: .venv\Scripts\activate
3. Installieren Sie Abhängigkeiten mit uv:
   uv pip install "mcp[cli]" "pydantic>=2.0.0"
4. Installieren Sie das Projektpaket im bearbeitbaren Modus:
   # Use pip for editable installs pip install -e .
5. Initialisieren/Aktualisieren der Datenbank:
   • Erstmalig: Führen Sie python setup_law_office.py aus (folgen Sie den Anweisungen). Stellen Sie sicher, dass dieses Skript vorhanden ist und das in der Spezifikation definierte Schema erstellt.
   • Updates anwenden (z. B. neue Trigger): Führen Sie python db_schema_update.py (oder ähnliche Update-Skripte) aus. Sichern Sie immer vorher Ihre Datenbank!

Verwendung

Manuelles Starten des Servers (zum Testen)

Stellen Sie sicher, dass Ihre virtuelle Umgebung aktiv ist ( source .venv/bin/activate ) und führen Sie Folgendes aus:

Claude Desktop-Integration (empfohlen)

1. Suchen Sie nach der Datei claude_desktop_config.json . Häufige Speicherorte:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. Fügen Sie den mcpServers -Eintrag hinzu oder ändern Sie ihn.
   • Ersetzen Sie <absolute_path_to_repo> durch den vollständigen Pfad, unter dem Sie dieses Repository geklont haben.
   • Stellen Sie sicher, dass der ausführbare Pfad von Python für Ihr Betriebssystem korrekt ist (z. B. <absolute_path_to_repo>/.venv/bin/python3 oder <absolute_path_to_repo>\.venv\Scripts\python.exe ).
   • Verwenden Sie den in server_law_office.py definierten Servernamen (der „law-office-sqlite“ lautet).
   { "mcpServers": { "law-office-sqlite": { "command": "<absolute_path_to_repo>/.venv/bin/python3", "args": [ "-m", "mcp_server_sqlite", "--db-path", "<absolute_path_to_repo>/database/law_office.db", "--log-level", "INFO" ], "cwd": "<absolute_path_to_repo>" } } }

   (Hinweis: Bei der Verwendung python -m mcp_server_sqlite wird davon ausgegangen, dass Ihr Paket korrekt installiert und sein Einstiegspunkt konfiguriert ist.)

3. Speichern Sie die Konfigurationsdatei.
4. Starten Sie Claude Desktop neu. Der Server "law-office-sqlite" sollte nun im MCP-Integrationsmenü erscheinen.

Entwicklungsnotizen

• Der Server ist für die Datenintegrität (Zeitstempel, Rechnungssummen, Ablehnung von Zeitkonflikten) stark auf Datenbanktrigger angewiesen. Schema- und Triggerdetails finden Sie im Spezifikationsdokument. Stellen Sie sicher, dass diese setup_law_office.py oder einer ähnlichen Datei korrekt definiert sind.
• Die zentrale Multi-Pass-Abrechnungslogik soll vom KI-Assistenten gesteuert werden, der der Systemaufforderung folgt und dabei die bereitgestellten Tools für die Datenbankinteraktion verwendet.