VibeLawyer MCP server

<!-- mcp-name: io.github.Jack-mi/vibelawyer -->

vibelawyer —— 通用化刑事案件阅卷 MCP

本地 FastMCP 阅卷工具箱。给定卷宗 PDF 目录，由 任意 Coding Agent（Cursor / Kimi Code / OpenCode / Codex / Claude Desktop 等）调用工具，产出：

• 阅卷笔录（Word .docx）—— 七部分结构 + 案件基本信息 + 阅卷结论（结构化数据完整渲染，无截断）
• 阅卷目录（Excel .xlsx）—— 分卷总览 / 阅卷目录 / 案件信息 / 证据索引

不依赖 Claude Code CLI。 LLM 推理由宿主 Agent 提供；PDF 解析、OCR、Word/Excel 生成均在本机完成，卷宗不经过本服务上传。

事实与证据须标注来源卷宗及页码（如 见《主卷》P55-76），并可机器校验，落实「禁止幻觉、结论可回溯」。

对任意刑事案件通用，不假定具体罪名或当事人。本仓库不收录真实卷宗；运行时将 PDF 放入本地 data/（已 gitignore），产物写入 output/（已 gitignore）。

两种用法（可穿插）

同一 caseid 下，完整流程与零散按需**共用全部工具，工作区状态共享。

可先按 playbook 走完大半，再零散补登；也可先散读若干页，再按 playbook 补齐缺步。服务端不强制锁步；顺序约束写在 Skill / playbook 里，由宿主 Agent 遵守。

架构

┌──────── 宿主 Coding Agent（Cursor / Kimi / OpenCode / Codex …）────────┐
│  读 skills/vibelawyer-review/SKILL.md；完整流程或按需调 MCP 工具        │
└───────────────────────────────┬───────────────────────────────────────┘
                                │ stdio / http
                                ▼
┌──────── vibelawyer-mcp（FastMCP）─────────────────────────────────────┐
│  create_case / 读卷 / record_* / validate / write_outputs / download   │
│  CaseWorkspace（case_id 隔离）+ 本机 PDF/OCR                            │
└───────────────────────────────┬───────────────────────────────────────┘
                                ▼
               docling → pypdfium2 → tesseract chi_sim
               → 阅卷笔录.docx + 阅卷目录.xlsx

startreview 只下发 playbook**，不启动后台 LLM job。

可选遗留：pip install 'vibelawyer[legacy-agent]' + python -m vibelawyer.run --legacy（需本机 Claude Code CLI，非默认路径）。

安装

pip install vibelawyer
# 开发安装
pip install -e .

• Python ≥ 3.11
• 无需 Claude Code CLI
• 可选（推荐）：本地 docling venv（~/.local/share/docling-venv）提升扫描件 OCR
• 可选：tesseract + chi_sim 作为 OCR 回退

接入宿主 Agent（推荐）

uvx vibelawyer
# 等价别名：
# uvx --from vibelawyer vibelawyer-mcp
# 已 pip install 时：vibelawyer 或 vibelawyer-mcp

Cursor / 通用 mcp.json

{
  "mcpServers": {
    "vibelawyer": {
      "command": "uvx",
      "args": ["vibelawyer"]
    }
  }
}

Claude Desktop（claudedesktopconfig.json）

{
  "mcpServers": {
    "vibelawyer": {
      "command": "uvx",
      "args": ["vibelawyer"]
    }
  }
}

Kimi Code / OpenCode / Codex

在各自 MCP 配置中填入同一 command / args。已安装包时可将 command 改为 vibelawyer（或别名 vibelawyer-mcp）、args 留空。本地 CLI 指引用 vibelawyer-cli。

配置完成后，让 Agent 阅读并遵循：

skills/vibelawyer-review/SKILL.md

（或调用 start_review 获取与 Skill 同源的结构化 playbook。）

典型流程

A. 完整阅卷

（可选 defendanthint / chargehint / output_dir）

1. createcase(casedir="/绝对路径/到卷宗目录") → case_id

每步用 getcasestatus 或 getworkspacesummary 核实登记计数（勿信口头「已完成」）

1. startreview(caseid) → 拿到 steps / 铁律 / 调用约定
2. 按步：编目录 → 起诉书/当事人 → 被告供述 → 同案 → 证人 → 程序性文书 → 书证/流水 → 结论

1. validatecitations → writeoutputs → download_output(fmt="docx"|"xlsx")

B. 按需单次调用

Shortened. The full README is on GitHub.