contract-ops-mcp

Name: contract-ops-mcp
Author: DrBaher

本地服务

github.com/DrBaher法律与政务015 周前更新

代码仓库

关于 contract-ops-mcp

contract-ops-mcp 将 contract-ops 套件中的 9 个本地优先 CLI 封装为 MCP 工具，面向处理合同提取、起草、审查和归档的 Agent。签署操作保留人工控制，并通过路径限制和只读工具降低风险。

主要功能

01提取并结构化合同内容
02检查一致性并比较合同版本
03填充模板并转换为 PDF
04搜索模板及已签署合同登记
05验证签名与审计记录
06查询 CLI 状态并调用工具

适用场景

01从 PDF 或 DOCX 提取合同条款
02检查合同占位符和引用错误
03查找模板并填充合同草稿
04查询续约期限及合同风险

MCP 相关

MCP 服务将 contract-ops CLI 套件的工具提供给 Agent 客户端。签署保持人工控制，文件路径受基础目录限制，命令通过不使用 shell 的方式执行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "drbaher-contract-ops": {
      "command": "npx",
      "args": [
        "-y",
        "contract-ops-mcp"
      ]
    }
  }
}

启动命令npx -y contract-ops-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmcontract-ops-mcp0.3.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
path	string	是	合同文件的路径（位于基础目录内）。

详细介绍

contract-ops-mcp

一个 MCP 服务，整合了整个 contract-ops CLI 套件——只需配置一次，Agent（Claude、Cursor、Codex，……）即可将全部九个本地优先的 CLI 用作工具：提取、起草、检查、比较、转换、审阅，以及模板库和已签署合同库。签署仍须由人工把关。

运行

// e.g. Claude Desktop / Cursor MCP config
{
  "mcpServers": {
    "contract-ops": { "command": "npx", "args": ["-y", "contract-ops-mcp"] }
  }
}

必须先安装各 CLI（该服务会调用它们）。安装全部九个 CLI 的最快方式：

curl -fsSL https://cli.drbaher.com/install.sh | sh     # local
# …or run the server + CLIs in one container: ghcr.io/drbaher/contract-ops

随时调用 suite_status，查看已安装的 CLI，以及如何安装尚未安装的 CLI。

更喜欢开箱即用的 Agent？ contract-ops-agent 是一个终端 Agent，它已经将此服务封装在一个 隔离环境 中——模型唯一可用的工具就是 contract-ops 工具，因此无法通过设计使用 shell、文件系统或签署功能。模型由你自选（Claude、OpenAI，或任何 OpenAI 兼容端点）：npm i -g contract-ops-agent。

工具

针对常见操作精心挑选、易于使用的工具（输入经过类型定义，输出为 JSON），另有两个用于处理其他需求的备用入口：

工具	功能
`extract_contract`	任意合同（.md/.txt/.html/.docx/.pdf）→ 结构化 JSON（各方、日期、条款，……）
`lint_contract`	查找内部一致性问题（占位符、失效引用、定义术语／编号／日期缺陷）
`compare_versions`	比较两个版本的条款差异（退出码：0 表示无差异 · 2 表示实质性差异 · 3 表示形式性差异 · 4 表示位置变更）
`fill_template`	使用带类型的参数填充模板占位符（结果确定）
`convert_to_pdf`	DOCX → PDF（需要 PDF 后端，例如 LibreOffice）
`review_nda`	根据内部审查手册评估 NDA，并提供依据
`template_vault_find` / `template_vault_get`	搜索／获取有版本管理的模板（只读）
`contract_vault_query` / `contract_vault_due` / `contract_vault_risk`	查询已签署合同登记库；预测续约／通知期限；评估续约风险敞口（只读）
`verify_signature` / `verify_receipt` / `audit_show`	验证已签署的 PDF／收据包／查看审计日志（只读）
`catalog(cli)`	返回任意 CLI 的完整 `--catalog json`——用于发现其他功能
`run(cli, args)`	备用入口：使用原始参数运行任意套件 CLI（不使用 shell）
`suite_status`	查看已安装的 CLI（及其版本），以及如何安装其余 CLI

精选工具集和 catalog/run 由发现机制驱动——它们遵循套件统一的 --catalog json 契约，因此会随着 CLI 的演进保持同步。

安全性

签署须由人工把关。 仅开放 sign-cli 的读取／验证操作（verify_signature、verify_receipt、audit_show）——绝不开放创建请求或签署功能。这一限制由机制强制执行：run/catalog 备用入口会拒绝任何不在只读许可列表内的 sign 子命令，因此无法通过此处调用创建请求／发送／签署／批准功能。这些功能仍受 sign-cli 自身的 MCP 服务保护，并使用针对每位签署人的审批令牌，因此此服务无法成为不受保护的签署途径。
锁定文件系统。 精选工具中的文件路径参数仅限于 CONTRACT_OPS_MCP_BASE_DIR（默认为工作目录）。设置该变量可扩大沙盒范围。
不使用 shell。 CLI 通过 execFile 调用（不进行 shell 插值）。