Servidor SQLite MCP para bufetes de abogados

Una implementación de servidor de Protocolo de Contexto Modelo (MCP) para la gestión de bases de datos de bufetes de abogados, especializada en registros de clientes, presentación de casos, seguimiento del tiempo y gestión de facturas.

Descripción general

Este servidor proporciona una interfaz de base de datos especializada para que los bufetes de abogados puedan:

• Gestionar registros de clientes y asuntos
• Realizar un seguimiento de las entradas del expediente (documentos, comunicaciones, notas)
• Registre el tiempo facturable con vínculos probatorios a las actividades del caso
• Crear y validar facturas de clientes
• Aplicar reglas comerciales para una facturación legal adecuada

Características

Operaciones básicas de la base de datos

• Operaciones SQL estándar (SELECT, INSERT, UPDATE, DELETE)
• Gestión de tablas e información del esquema
• Transacciones de múltiples declaraciones y operaciones por lotes mediante la herramienta execute_script

Herramientas legales especializadas

• record_case_entry : Agregar documentación a los archivos de casos
• record_billable_time : Registrar el tiempo con la justificación adecuada
• get_unbilled_time : Realiza un seguimiento del trabajo no facturado por cliente o asunto
• create_invoice : Generar nuevas facturas de clientes
• add_billing_to_invoice : Asociar entradas de tiempo con facturas
• check_invoice_validity : Validar facturas para detectar conflictos de facturación
• submit_invoice : Finalizar facturas para el envío al cliente

Esquema de base de datos

• Gestión de clientes y asuntos
• Sistema de documentación de expedientes
• Flujo de trabajo integral de facturación y facturación
• Gestión automática de marcas de tiempo
• Detección de conflictos por entradas de tiempo superpuestas

Instalación

Prerrequisitos

• Python 3.10 o superior (se recomienda Python 3.11 o superior) . Consulte con python3.11 --version (o similar). Si es necesario, instálelo con el gestor de paquetes de su sistema (p. ej., brew install python@3.11 en macOS).
• uv : Instalador rápido de paquetes de Python. Se instala desde astral.sh ( curl -LsSf https://astral.sh/uv/install.sh | sh ).
• SQLite3 (generalmente preinstalado en macOS/Linux).
• Git (para clonar).

Instrucciones de configuración

1. Clonar el repositorio:
   git clone <repository_url> # Replace with your repo URL cd mcp-law-office-db # Or your repository directory name
2. Cree y active un entorno virtual (utilizando su intérprete de Python 3.10+):
   # Replace python3.11 with your specific version (e.g., python3.10) python3.11 -m venv .venv source .venv/bin/activate
   (Deberías ver (.venv) al comienzo del indicador de tu terminal)
3. Actualizar pip (opcional pero recomendado):
   python3 -m pip install --upgrade pip
4. Instalar dependencias usando uv : (Esto instala mcp y sus extras, además de pydantic )
   uv pip install "mcp[cli]" "pydantic>=2.0.0"
5. Instalar el paquete del proyecto en modo editable:
   pip install -e .
6. Inicializar la base de datos: (Este script configura el esquema SQLite)
   python setup_law_office.py
   (Siga las instrucciones para agregar opcionalmente datos de muestra)

Uso

Iniciar el servidor manualmente (para pruebas)

Asegúrese de que su entorno virtual esté activo ( source .venv/bin/activate ) y ejecute:

Integración de escritorio de Claude (recomendado)

1. Encuentra tu archivo claude_desktop_config.json .
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. Agregue o modifique la entrada mcpServers para este servidor. Reemplace <absolute_path_to_repo> con la ruta completa donde clonó el repositorio (p. ej., /Users/andrewsirulnik/claude_mcp_servers/mcp-law-office-db ).
   { "mcpServers": { "law-office_db": { "command": "<absolute_path_to_repo>/.venv/bin/python3", "args": [ "<absolute_path_to_repo>/run_server.py", "--db-path", "<absolute_path_to_repo>/database/law_office.db" ], "cwd": "<absolute_path_to_repo>" } // Add other servers here if needed } // Other Claude Desktop settings... }
3. Guarde el archivo de configuración.
4. Reinicie Claude Desktop. El servidor debería estar disponible en el menú de integración de MCP.