mcp-legal-doc-analyzer

MCP 法律文档分析器

npm mcp-legal-doc-analyzer 包

面向法律文档工作流的领域专用 MCP 工具。提取合同中的关键条款，根据可配置的规则模板标记风险条款，按条款级别比较文档版本，并依据标准清单检查合规性——所有操作均在本地完成，文档不会离开你的设备。

工具参考 | 配置 | 贡献 | 故障排除

主要功能

• 条款提取：从 PDF、DOCX 和纯文本文件中识别并标注条款边界（终止、责任、知识产权、管辖法律等）。
• 风险标记：根据 YAML 规则模板检查提取出的条款，并返回按严重程度排序的发现结果。
• 合规检查：根据结构化清单（NDA、雇佣协议、SaaS 条款）验证文档，并逐项给出通过/未通过结果。
• 版本差异比较：在条款级别比较两个文档版本，而非比较原始文本行。
• 可配置模板：规则集采用 YAML 文件，法律专业人士无需编写代码即可审查和编辑。
• 仅限本地处理：所有解析和分析均在设备上运行；文档绝不会传输到外部。

免责声明

mcp-legal-doc-analyzer 是辅助分析工具，不构成法律建议。作出决定前，应由具备资质的法律专业人士审查输出结果。条款提取使用模式匹配和启发式方法；对于非标准文档格式，结果可能不完整或不准确。系统会明确标记置信度较低的提取结果。

文档内容在本地处理，并存储在本地 SQLite 数据库中。请勿共享包含机密文档的数据库导出文件。

要求

• Node.js v20.19 或更高版本。
• npm。

开始使用

将以下配置添加到你的 MCP 客户端：

{
  "mcpServers": {
    "legal-analyzer": {
      "command": "npx",
      "args": ["-y", "mcp-legal-doc-analyzer@latest"]
    }
  }
}

要从目录加载自定义合规模板：

{
  "mcpServers": {
    "legal-analyzer": {
      "command": "npx",
      "args": ["-y", "mcp-legal-doc-analyzer@latest", "--templates=~/legal/my-templates"]
    }
  }
}

MCP 客户端配置

Amp · Claude Code · Cline · Cursor · VS Code · Windsurf · Zed

第一个提示词

提供 PDF 或 DOCX 合同文件，然后输入：

Extract the key clauses from this NDA and flag any risky provisions.

客户端应返回提取出的条款列表，以及按严重程度排序的风险报告。

工具

文档分析（4 个工具）

• extract_clauses — 识别并标注条款边界及置信度分数；支持 .pdf、.docx、.txt
• flag_risks — 根据合规模板生成按严重程度排序的风险发现结果
• check_compliance — 按规则逐项验证结构化清单，并给出通过/未通过结果
• summarize_terms — 使用通俗易懂的要点总结关键条款

比较（1 个工具）

• compare_versions — 在条款级别比较两个文档版本的差异

模板（1 个工具）

• list_templates — 列出所有可用的合规模板

导出与批量处理（3 个工具）

• export_analysis_report — 生成独立的 HTML 报告，包含条款表和风险发现结果；适合打印
• export_audit_log — 以 JSON 或 CSV 格式导出分析审计日志，可选择按日期范围筛选
• bulk_analyze — 批量处理一组合同文件，并发送进度通知

内置模板

开箱即用，包含九个合规模板：

1. NDA
2. 雇佣协议
3. SaaS 客户协议
4. 软件许可协议
5. 供应商协议
6. 咨询协议
7. 数据处理协议
8. 知识产权转让
9. 贷款协议

使用 list_templates 可在运行时列出所有可用模板，包括通过 --templates 加载的任何自定义模板。

配置

--templates / --templates-dir

用于加载自定义 YAML 合规规则模板的目录。此目录中的模板将与内置模板集合合并。

类型：string

--db / --db-path

用于存储文档分析历史记录的 SQLite 数据库文件路径。

类型：string 默认值：~/.mcp/legal.db

--confidence-threshold

纳入结果的提取条款所需的最低置信度分数（0–1）。低于此阈值的提取结果会被标记为低置信度。

类型：number 默认值：0.6

--no-history

禁用将文档分析结果存储在本地数据库中。

类型：boolean 默认值：false

--clause-patterns

定义自定义条款检测模式的 YAML 文件路径。有关模式结构，请参阅源代码树中的 custom-clause-patterns.example.yaml。

类型：string

--bulk-concurrency

使用 bulk_analyze 时并行处理的文件数量。

类型：number 默认值：4

--ocr

为不含可提取文本层的扫描版 PDF 启用 OCR 回退。需要可选的对等依赖项 tesseract.js、pdfjs-dist 和 canvas。

类型：boolean 默认值：false

--http-port

在指定端口以 Streamable HTTP 模式启动服务，而不是使用 stdio。设置后，服务将接受适用于团队共享部署的 HTTP 连接。

类型：number

通过 JSON 配置中的 args 属性传递标志：

{
  "mcpServers": {
    "legal-analyzer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-legal-doc-analyzer@latest",
        "--confidence-threshold=0.8",
        "--templates=~/legal/templates"
      ]
    }
  }
}

验证

发布新版本前，使用 MCP Inspector 验证服务，确认所有工具均已正确公开，且协议握手成功。

先运行 npm run build，确保验证期间 dist/templates 中包含打包后的模板。

交互式 UI（打开浏览器）：

npm run build && npm run inspect

CLI 模式（适用于脚本 / CI）：

# List all tools
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

# List resources and prompts
npx @modelcontextprotocol/inspector --cli node dist/index.js --method resources/list
npx @modelcontextprotocol/inspector --cli node dist/index.js --method prompts/list

# Call a tool (example — replace with a relevant read-only tool for this plugin)
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name list_templates

# Call a tool with arguments
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name list_templates --tool-arg key=value

发布前运行，以发现工具注册和运行时启动方面的回归问题。

贡献

合规规则模板以 YAML 文件的形式存放在 src/templates/ 中，无需修改代码即可贡献。条款提取测试必须仅使用合成或匿名化文档——切勿将真实合同纳入代码库。切勿记录文档内容。

npm install && npm test

MCP Registry 与 Marketplace

此插件可在以下平台获取：

• MCP Registry
• MCP Market

搜索 mcp-legal-doc-analyzer。