ClauseKeeper Compliance Scanner

ClauseKeeper MCP 服务

mcp-name: io.github.mityda/clausekeeper

clausekeeper-mcp 将 ClauseKeeper 的确定性合规扫描器封装为 Model Context Protocol（MCP）工具，供 Claude Desktop、Cursor 和其他 MCP 宿主使用。

它只是对 clausekeeper_core/scanner.py 中随包提供的 ClauseKeeper 扫描器，以及 clausekeeper_core/clause_rules.py 中规则库的轻量封装：

• 不调用大模型
• 不需要 API 密钥
• 不使用付费服务
• 通过官方 Python mcp SDK 使用 stdio 传输

工具

• scan_policy_text(text: str) — 使用随包提供的 ClauseKeeper 扫描器扫描粘贴的政策／法律文本，并返回评分、等级、计数、类别以及缺失／过时条款清单。
• scan_policy_url(url: str) — 获取 URL 内容，使用 ClauseKeeper 的 html_to_text 去除 HTML，然后扫描可见文本。
• list_clause_rules() — 返回随包提供的条款规则和类别。

在本地运行

在 ClauseKeeper 主仓库中运行：

cd mcp
uv run clausekeeper-mcp

uv run 会创建／使用本地项目环境，并自动安装 mcp SDK 依赖。由于这是一个 stdio MCP 服务，uv run clausekeeper-mcp 会等待 MCP 客户端通过 stdin/stdout 连接。

你也可以将其安装到指定的虚拟环境中：

cd mcp
uv venv
uv pip install --python .venv/bin/python -e .
.venv/bin/clausekeeper-mcp

或者直接运行：

cd /path/to/clausekeeper/mcp
uv run python server.py

MCP 宿主配置

请使用此 mcp 目录的绝对路径。

Claude Desktop

将以下内容添加到 Claude Desktop MCP 配置文件中：

{
  "mcpServers": {
    "clausekeeper": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/clausekeeper/mcp",
        "run",
        "clausekeeper-mcp"
      ]
    }
  }
}

Cursor 或其他 MCP 宿主

在 MCP 设置中使用相同的服务定义：

{
  "mcpServers": {
    "clausekeeper": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/clausekeeper/mcp",
        "run",
        "clausekeeper-mcp"
      ]
    }
  }
}

如果你的宿主不支持 uv --directory，请改用虚拟环境中已安装的控制台脚本：

{
  "mcpServers": {
    "clausekeeper": {
      "command": "/absolute/path/to/clausekeeper/mcp/.venv/bin/clausekeeper-mcp",
      "args": []
    }
  }
}

使随包提供的扫描器保持同步

clausekeeper_core/ 包随包提供，源自主应用的 app/scanner.py 和 app/clause_rules.py，因此 MCP 包在 PyPI／注册表安装时可独立运行。当 app/ 中的扫描器或条款规则发生变化时，请在此处更新对应的随包文件，并重新运行 MCP 自包含性和一致性检查。

发布元数据

此处未包含 server.json，因为当前 OSS MCP Community Registry／GitHub MCP Registry 的元数据格式应在发布时依据注册表文档确认。发布时，请添加注册表要求的元数据文件，其中包含包名称、描述、许可证、仓库 URL、运行时命令和工具列表。

主项目

请参阅 ClauseKeeper 主项目：../README.md。