Law Office SQLite MCP Server

Юридическая контора SQLite MCP сервер

Реализация сервера Model Context Protocol (MCP) для управления базами данных юридических контор, специализирующаяся на клиентских записях, подаче дел, отслеживании времени и управлении счетами.

Обзор

Этот сервер предоставляет специализированный интерфейс базы данных для юридических фирм, позволяя помощникам на базе искусственного интеллекта (таким как Клод) взаимодействовать с критически важными практическими данными для:

• Управление записями клиентов и дел.
• Отслеживайте записи в материалах дела (документы, сообщения, заметки) с помощью правил дословного содержания.
• Регистрируйте оплачиваемое время с подробным обоснованием, уровнями достоверности и ссылками на действия по делу.
• Создавайте, проверяйте и управляйте счетами клиентов в соответствии с определенными рабочими процессами.
• Обеспечивать соблюдение правил ведения бизнеса для надлежащего законного выставления счетов, включая строгое предотвращение конфликтов сроков.
• Создавайте форматированные отчеты, такие как еженедельные табели учета рабочего времени.
• Отслеживайте сроки и события календаря.

Функции

Основные операции с базой данных

• Стандартные операции SQL (SELECT, INSERT, UPDATE, DELETE) с помощью специальных инструментов ( read_query , write_query ).
• Управление таблицами ( create_table ) и информация о схеме ( describe_table , list_tables ).
• Многооператорные транзакции и пакетные операции с помощью инструмента execute_script (используйте точку с запятой в качестве разделителя).

Специализированные юридические инструменты (основные моменты)

• record_case_entry : Добавляет документы/электронные письма в файлы дел с метаданными.
• record_billable_time : регистрирует время с необходимым обоснованием, уровнями достоверности и обоснованием.
• get_unbilled_time : Отслеживает неоплаченную работу по клиенту или вопросу.
• create_invoice , add_billing_to_invoice , check_invoice_validity , submit_invoice : Управление жизненным циклом счета.
• generate_weekly_timesheet : создает отформатированные табели учета рабочего времени для проверки. (Примечание: update_case_entry_synopsis и calculate_billing_hours описаны в спецификации, но пока не реализованы как отдельные инструменты).

Схема и логика базы данных

• Таблицы для клиентов, вопросов, записей в досье, записей о выставлении счетов, счетов-фактур, позиций счетов-фактур и событий календаря (см. документ «Спецификация»).
• Комплексная поддержка рабочего процесса выставления счетов и выставления счетов.
• Автоматическое управление временными метками created и last_modified .
• Строгое предотвращение конфликтов: триггеры базы данных (ПЕРЕД ВСТАВКОЙ/ОБНОВЛЕНИЕМ в billing_entries ) автоматически отклоняют попытки сохранить записи времени, которые пересекаются с ранее зафиксированным временем в отправленных счетах-фактурах.

Динамические ресурсы

• Резюме по всем делам ( case://summary/all ) или конкретным делам ( case://summary/{matter_id} ).
• Отчеты по выставлению счетов по всем записям ( billing://report/all ), конкретным вопросам ( billing://report/{matter_id} ) или клиентам ( billing://client/{client_id} ).
• Подробный просмотр счетов-фактур ( invoice://detail/{invoice_id} ).
• Списки предстоящих крайних сроков ( deadline://list/{matter_id} ).

Подсказки с инструкциями

• Структурированные подсказки для запуска общих рабочих процессов, таких как создание новых дел ( new-matter ), анализ выставления счетов ( billing-analysis ), создание счетов-фактур ( create-invoice ) и добавление документов ( document-intake ). (Примечание: case-timeline описан в спецификации, но еще не реализован).

Установка

(Предполагаются следующие предварительные условия: Python 3.10+, uv, SQLite3, Git)

1. Клонируйте репозиторий:
   git clone <repository_url> # Replace with your repo URL cd mcp-law-office-db # Or your repository directory name
2. Создайте и активируйте виртуальную среду:
   # 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. Установите зависимости с помощью uv:
   uv pip install "mcp[cli]" "pydantic>=2.0.0"
4. Установите пакет проекта в редактируемом режиме:
   # Use pip for editable installs pip install -e .
5. Инициализация/обновление базы данных:
   • Первый раз: Запустите python setup_law_office.py (следуйте подсказкам). Убедитесь, что этот скрипт существует и создает схему, определенную в Спецификации.
   • Применение обновлений (например, новых триггеров): Запустите python db_schema_update.py (или аналогичные предоставленные скрипты обновления). Всегда сначала делайте резервную копию базы данных!

Использование

Запуск сервера вручную (для тестирования)

Убедитесь, что ваша виртуальная среда активна ( source .venv/bin/activate ) и выполните:

Интеграция Claude Desktop (рекомендуется)

1. Найдите файл claude_desktop_config.json . Обычные расположения:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. Добавьте или измените запись mcpServers .
   • Замените <absolute_path_to_repo> на полный путь к месту, куда вы клонировали этот репозиторий.
   • Убедитесь, что путь к исполняемому файлу Python указан правильно для вашей ОС (например, <absolute_path_to_repo>/.venv/bin/python3 или <absolute_path_to_repo>\.venv\Scripts\python.exe ).
   • Используйте имя сервера, определенное в server_law_office.py (то есть «law-office-sqlite»).
   { "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>" } } }

   (Примечание: использование python -m mcp_server_sqlite предполагает, что ваш пакет установлен правильно и его точка входа настроена.)

3. Сохраните файл конфигурации.
4. Перезапустите Claude Desktop. Сервер "law-office-sqlite" должен появиться в меню интеграции MCP.

Заметки о разработке

• Сервер в значительной степени полагается на триггеры базы данных для обеспечения целостности данных (временные метки, итоговые суммы счетов, отклонение конфликта времени). Подробности схемы и триггера см. в документе «Спецификация». Убедитесь, что setup_law_office.py или аналогичный файл правильно их определяет.
• Основная логика многопроходного выставления счетов будет управляться помощником на базе искусственного интеллекта, который будет следовать подсказкам системы, используя предоставленные инструменты для взаимодействия с базой данных.