Page Monitor

page-monitor-mcp-server

确定性的网页变更监控 MCP 服务，提供 SHA-256 快照证据。免费比较单个页面，无需密钥；使用来自 https://toplformater.click 的 Cat1 API 密钥即可进行 7x24 定时监控。

功能

• 经过噪声过滤的确定性差异比较（cat1_diff_page）：将目标网页（或本地 HTML）与基线进行比较，剔除动态噪声——<script>/<style>、随机 nonce/request-id、动态计数器、相对时间戳以及 JSON 缩进差异——并返回规范化文本的 SHA-256 哈希、结构化变更摘要和统一差异。免费使用，无需密钥、账户或银行卡。
• SHA-256 加密证据链：每次调用 cat1_diff_page 都会记录 baseline_sha256、target_sha256、diff_patch_sha256、structured_changes 和 unified_diff，因此任何结果都可以独立重新获取并通过哈希验证。不会臆造变更。
• 7x24 定时监控门控（cat1_schedule_monitor）：为持续运行的定时监控申请或验证 Cat1 API 密钥。没有密钥时，会返回获取密钥的指引，网址为 https://toplformater.click（29 美元/月，7 天免费试用，无需银行卡）。有密钥时，只会在本地检查密钥格式（^cat1_(?:live|trial)_[A-Za-z0-9]{16,64}$）；绝不会调用外部支付或验证端点、伪造验证结果，也不会假装在本地运行定时任务。实际的 7x24 监控由我们自己的云服务执行。该工具会如实报告 local_scheduler_started: false 和 online_verified: false。

工具

工具	是否需要密钥	用途
cat1_diff_page	否	免费比较单个页面，过滤噪声并提供 SHA-256 证据。输入：target_url（必填）、baseline_source（可选）、baseline_sha256（可选）。
cat1_schedule_monitor	可选（门控）	定时监控密钥门控与使用指引。输入：target_url（必填）、interval_minutes（可选，默认值为 15）、alert_email（可选）、api_key（可选，或使用 CAT1_API_KEY 环境变量）。

快速开始

要求

• Python 3.9+（仅使用标准库，零第三方依赖），或使用 Docker 运行 OCI 镜像。

选项 A -- 从源代码运行

git clone https://github.com/jhfg31410-ai/page-monitor-mcp-server.git
cd page-monitor-mcp-server
python3 server.py

选项 B -- 使用 Docker 运行（镜像发布后）

docker run -i --rm ghcr.io/jhfg31410-ai/page-monitor-mcp-server:0.1.0

Claude Desktop / Cursor 配置

将 claude_desktop_config.example.json 复制到 MCP 客户端配置中，并设置服务路径（或 Docker 镜像）。示例（源代码）：

{
  "mcpServers": {
    "page-monitor-mcp-server": {
      "command": "python3",
      "args": ["/path/to/page-monitor-mcp-server/server.py"],
      "env": {
        "CAT1_API_KEY": "YOUR_CAT1_KEY_HERE_OPTIONAL"
      }
    }
  }
}

定价

• 单页差异比较（cat1_diff_page）：免费使用，无需密钥、账户或银行卡。
• 7x24 定时监控：29 美元/月，7 天免费试用，无需银行卡。在 https://toplformater.click 获取正式 API 密钥。所有付款均通过我们自己的网站（Paddle / PayPal）处理；此服务不会处理付款。

文件

• server.py -- MCP stdio 服务（实现 initialize、tools/list、tools/call 和密钥门控）。
• engine.py -- 噪声过滤与语义差异比较核心（SHA-256、结构化差异）。
• server.json -- 官方 MCP Registry 描述文件（公开仓库和 Docker 镜像尚未创建或发布）。
• Dockerfile -- OCI 镜像构建文件（Python 3.12-slim，零依赖）。
• requirements.txt -- 软件包列表（零第三方依赖，仅使用 Python >= 3.9 标准库）。
• claude_desktop_config.example.json -- Claude Desktop / Cursor 挂载示例（仅含占位密钥）。
• fixtures/t0_sample.html、fixtures/t1_sample.html -- 本地差异测试用 HTML 快照。

本地测试命令

列出工具（tools/list）

printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05"}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}\n' | python3 server.py

免费差异测试（cat1_diff_page，无需密钥）

printf '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"cat1_diff_page","arguments":{"baseline_source":"fixtures/t0_sample.html","target_url":"fixtures/t1_sample.html"}}}\n' | python3 server.py

密钥门控测试（cat1_schedule_monitor）

无密钥（返回使用指引）：

printf '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"cat1_schedule_monitor","arguments":{"target_url":"https://news.ycombinator.com/","interval_minutes":5}}}\n' | python3 server.py

使用格式匹配的演示密钥（仅本地格式检查；不进行网络验证，也不在本地运行定时任务）：

printf '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"cat1_schedule_monitor","arguments":{"target_url":"https://news.ycombinator.com/","interval_minutes":5,"api_key":"cat1_trial_DemoFormatCheckOnly9999"}}}\n' | python3 server.py

状态

• 版本 0.1.0。服务名称为 page-monitor-mcp-server。
• 此代码库已准备好发布到 Official MCP Registry（包含 server.json）并列入 Glama / PulseMCP。公开代码库、Docker 镜像和注册表提交尚未发布。
• 许可证：MIT（参见 LICENSE）。