律师事务所 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. 克隆仓库：

   git clone <repository_url> # 替换为你的仓库 URL
   cd mcp-law-office-db # 或者你的仓库目录名
   

2. 创建并激活虚拟环境（使用你的 Python 3.10+ 解释器）：

   # 将 python3.11 替换为你具体的版本（例如 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)，然后运行：

python run_server.py --db-path ./database/law_office.db

Claude 桌面集成（推荐）

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> 替换为你克隆仓库的完整路径（例如，/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 桌面应用程序。 现在该服务器应该可以在 MCP 集成菜单中使用了。