법률 사무소 SQLite MCP 서버

고객 기록, 사건 접수, 시간 추적 및 송장 관리를 전문으로 하는 법률 사무소 데이터베이스 관리를 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다.

개요

이 서버는 로펌에 다음과 같은 특수 데이터베이스 인터페이스를 제공합니다.

• 클라이언트 및 사건 기록 관리
• 사건 파일 항목(문서, 커뮤니케이션, 메모) 추적
• 사건 활동에 대한 증거 링크를 통해 청구 가능 시간을 기록합니다.
• 클라이언트 송장 생성 및 검증
• 적절한 법적 청구를 위한 비즈니스 규칙 시행

특징

핵심 데이터베이스 작업

• 표준 SQL 작업(SELECT, INSERT, UPDATE, DELETE)
• 테이블 관리 및 스키마 정보
• execute_script 도구를 통한 다중 명령문 트랜잭션 및 일괄 작업

전문 법률 도구

• record_case_entry : 사건 파일에 문서 추가
• record_billable_time : 적절한 근거를 바탕으로 시간을 기록합니다.
• get_unbilled_time : 클라이언트 또는 사안별로 청구되지 않은 작업을 추적합니다.
• create_invoice : 새로운 클라이언트 송장 생성
• add_billing_to_invoice : 시간 항목을 송장과 연결합니다.
• check_invoice_validity : 청구 충돌에 대한 송장 유효성 검사
• submit_invoice : 클라이언트 제출을 위한 송장 마무리

데이터베이스 스키마

• 고객 및 문제 관리
• 사건 파일 문서화 시스템
• 포괄적인 청구 및 송장 워크플로
• 자동 타임스탬프 관리
• 중복되는 시간 항목에 대한 충돌 감지

설치

필수 조건

• Python 3.10 이상(Python 3.11 이상 권장) . python3.11 --version (또는 이와 유사한 명령어)을 사용하여 설치하세요. 필요한 경우 시스템 패키지 관리자(예: macOS의 경우 brew install python@3.11 )를 사용하여 설치하세요.
• uv : 빠른 Python 패키지 설치 프로그램입니다. astral.sh 에서 설치하세요( curl -LsSf https://astral.sh/uv/install.sh | sh ).
• SQLite3 (일반적으로 macOS/Linux에 사전 설치됨).
• Git(복제용).

설치 지침

1. 저장소를 복제합니다.지엑스피1
2. 가상 환경을 만들고 활성화합니다(Python 3.10+ 인터프리터를 사용):
   # Replace python3.11 with your specific version (e.g., python3.10) python3.11 -m venv .venv source .venv/bin/activate
   (터미널 프롬프트 시작 부분에 (.venv) 가 표시되어야 합니다)
3. pip 업그레이드(선택 사항이지만 권장):
   python3 -m pip install --upgrade pip
4. uv 사용하여 종속성을 설치합니다. (이렇게 하면 mcp 와 추가 기능, 그리고 pydantic 설치됩니다.)
   uv pip install "mcp[cli]" "pydantic>=2.0.0"
5. 편집 가능한 모드로 프로젝트 패키지를 설치하세요:
   pip install -e .
6. 데이터베이스 초기화: (이 스크립트는 SQLite 스키마를 설정합니다)
   python setup_law_office.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
   • 리눅스: ~/.config/Claude/claude_desktop_config.json
2. 이 서버의 mcpServers 항목을 추가하거나 수정하세요. <absolute_path_to_repo> 저장소를 복제한 전체 경로(예: /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. 구성 파일을 저장합니다.
4. Claude Desktop을 다시 시작하세요. 이제 MCP 통합 메뉴에서 서버를 사용할 수 있습니다.