mcp-law-office-db

🚀 法律事务所 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/Linux 上执行 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 install -r requirements.txt # 假设项目包含一个 requirements 文件
   

4. 配置数据库：

   cp config.example.json config.json # 根据需要修改配置文件
   

5. 启动服务器：

   python app.py # 启动 MCP 服务
   

💻 使用示例

基础用法

连接数据库

import sqlite3
conn = sqlite3.connect('law_office.db')

创建事务记录

cursor = conn.cursor()
cursor.execute("INSERT INTO matters (client_id, matter_title) VALUES (?, ?)", ("CLIENT_001", "合同审查"))
conn.commit()

查询案件文件

cursor.execute("SELECT * FROM case_files WHERE matter_id = ?", ("MATTER_001",))
files = cursor.fetchall()
print(files)

高级用法

批量处理

./execute_script.sh "UPDATE clients SET status = 'active' WHERE region = 'east'"

时间记录

from mcp_server import record_time
record_time("CLIENT_001", "MATTER_001", 2.5, "合同审查会议")

📚 详细文档

在线文档

你可访问 法律事务所 MCP 服务器文档 获取更多详细信息。

支持

如需帮助或反馈问题，请联系 support@law officemcps.com。

此项目旨在为律师事务所提供一个高效、安全的数据库解决方案，简化日常操作并提升效率。