# mcp-legal-doc-analyzer 中文文档

规范地址：https://npmcn.com/package/mcp-legal-doc-analyzer/

版本：1\.0\.1
npm 元数据更新时间：2026-11-04T02:14:35.370Z
中文译文更新时间：2026-11-04T03:51:11.217Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/mcp-legal-doc-analyzer
原文对照：https://npmcn.com/package/mcp-legal-doc-analyzer/?lang=original
项目主页：https://github.com/dbsectrainer/mcp-legal-doc-analyzer#readme
源码仓库：https://github.com/dbsectrainer/mcp-legal-doc-analyzer

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：156 kB，54 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.19\.0
- 运行依赖：7 个
- 首次发布：2026-03-23T19:56:33.212Z
- 最新版本发布：2026-11-04T02:14:35.159Z
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

用于法律文档工作流的领域特定的MCP工具

## 安装

```sh
npm install mcp-legal-doc-analyzer
```

也可以使用：`pnpm add mcp-legal-doc-analyzer`、`yarn add mcp-legal-doc-analyzer`、`bun add mcp-legal-doc-analyzer`

## README

# MCP法律文件分析器

npm `mcp-legal-doc-analyzer` 包

用于法律文档工作流的领域特定的MCP工具。从合同中提取关键子句，根据可配置的规则模板标记有风险的条款，在子句级别比较文档版本，并根据标准清单检查遵从性—所有这些都在本地进行，而无需文档离开您的机器。

[参考工具](https://npmcn.com/package/mcp-legal-doc-analyzer/#readme-tools) | [配置](https://npmcn.com/package/mcp-legal-doc-analyzer/#readme-configuration) | [贡献](https://npmcn.com/package/mcp-legal-doc-analyzer/#readme-contributing) | [故障排除](https://npmcn.com/package/mcp-legal-doc-analyzer/#readme-troubleshooting)

## 关键特性

-   **条款提取**：从PDF、DOCX和纯文本文件中识别和标记条款边界（终止、责任、知识产权、适用法律等）。
-   **低迷的风险**：根据YAML规则模板检查提取的子句，并返回按严重程度排序的结果。
-   **合规检查**：根据结构化清单（保密协议、雇佣协议、SaaS条款）根据每个要求的通过/不通过来验证文档。
-   **版本dif**：在子句级别比较文档的两个版本——而不是原始文本行。
-   **可配置的模板**：规则集是法律专业人员无需编写代码即可审查和编辑的YAML文件。
-   **只处理**：所有解析和分析都在设备上运行；文件从不对外传输。

## 免责声明

`mcp-legal-doc-analyzer` 是分析援助，不是法律建议。在作出决定之前，应由合格的法律专业人员审查产出。子句提取采用模式匹配和启发式方法；对于非标准文档格式，结果可能不完整或不正确。低置信度的提取被显式标记。

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

## 需求

-   Node.js v20.19或更新版本。
-   npm。

## 开始

在MCP客户端中添加以下配置：

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

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

```json
{
  "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` -批量处理合同文件组合并提供进度通知

## 绑定模板

9个合规模板包括开箱即用：

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`

传递标志 `args` 属性在JSON配置中：

```json
{
  "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` 在验证过程中出现。

**交互式用户界面** (打开浏览器):

```bash
npm run build && npm run inspect
```

**CLI模式** （脚本/ ci友好）：

```bash
# 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
```

在发布之前运行，以在工具注册和运行时启动时捕获回归。

## 贡献

遵从性规则模板 `src/templates/` 作为YAML文件，并且可以在不接触代码的情况下贡献。子句提取测试必须只使用合成的或匿名的文档——永远不要在存储库中包含真正的合同。不要记录文档内容。

```bash
npm install && npm test
```

## MCP注册和市场

此插件可用于：

-   [MCP注册表](https://registry.modelcontextprotocol.io/)
-   [MCP市场](https://mcpmarket.com/)

搜索 `mcp-legal-doc-analyzer`。

## 常见问题

### mcp-legal-doc-analyzer 是什么？

用于法律文档工作流的领域特定的MCP工具

### 如何安装 mcp-legal-doc-analyzer？

在项目目录运行 npm install mcp-legal-doc-analyzer，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-legal-doc-analyzer，可以用 npx mcp-legal-doc-analyzer 直接运行。

### mcp-legal-doc-analyzer 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/mcp-legal-doc-analyzer 是否存在。

### mcp-legal-doc-analyzer 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### mcp-legal-doc-analyzer 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### mcp-legal-doc-analyzer 可以商用吗？

mcp-legal-doc-analyzer 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### mcp-legal-doc-analyzer 还在维护吗？

最新版本 1\.0\.1 发布于 2026/11/04（今天）；至今共发布 2 个版本，其中过去 12 个月发布了 2 个；首次发布于 2026/03/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

