Clearon Legislation Monitor MCP

用于审查门控的美国立法发现和观察列表监控的 MCP 服务器。

它将发现线索与已验证的观察列表条目区分开来，记录仅追加的观察和异常，并在法案成为权威之前保持官方来源审查的参与。

它能做什么

• 记录发现候选，而不会静默地将它们提升到观察列表中

• 在观察列表接受之前要求明确的人工审查

• 跟踪官方来源观察、到期审查和检索异常

• 将仅追加的事件日志重放为可重建的快照

• 可选地使用 Open States 和 NYC Legistar 作为发现辅助工具，绝不作为最终证明

Related MCP server: universal-research-mcp

它不能做什么

• 它不发布内容，也不修改 WordPress

• 它不将关键词命中视为法律验证

• 它不将第三方发现结果视为记录来源状态

• 它不会将检索失败转换为法律状态变更

要求

• Node.js 20 或更高版本

• 能够启动 stdio 服务器的本地 MCP 客户端

安装

cd tools/clearon-legislation-monitor-mcp
npm install
npm test
npm run smoke

MCP 客户端配置

stdio 配置示例：

{
  "mcpServers": {
    "clearon-legislation-monitor": {
      "command": "node",
      "args": ["/absolute/path/to/clearon-legislation-monitor-mcp/server.mjs"],
      "env": {
        "CLEARON_LEGISLATION_WORKSPACE": "/absolute/path/to/workspace"
      }
    }
  }
}

如果你的规范化跟踪器输入不在默认工作区位置，还需设置：

• CLEARON_LEGISLATION_REGISTRY_PATH

• CLEARON_LEGISLATION_WATCHLIST_PATH

存储

默认情况下，监控器状态存储在仓库之外的用户数据目录中：

• macOS: ~/Library/Application Support/clearon-legislation-monitor-mcp/legislation-monitor

• Linux: ${XDG_DATA_HOME:-~/.local/share}/clearon-legislation-monitor-mcp/legislation-monitor

• Windows: %APPDATA%\\clearon-legislation-monitor-mcp\\legislation-monitor

使用 CLEARON_LEGISLATION_MONITOR_ROOT 覆盖该位置。

规范跟踪器输入仍应来自你选择的工作区：

• trackers/state-legislation/jurisdictions.json

• trackers/state-legislation/watchlist.csv

除非你通过环境变量显式覆盖它们。

凭据

可选的服务提供商密钥可以直接在环境中提供：

• OPENSTATES_API_KEY

• NYC_LEGISTAR_TOKEN

服务器还支持可选的本地密钥文件。默认情况下，它会查找：

• macOS: ~/Library/Application Support/openclaw/local-secrets.json

• Linux: ${XDG_CONFIG_HOME:-~/.config}/openclaw/local-secrets.json

• Windows: %APPDATA%\\openclaw\\local-secrets.json

使用 OPENCLAW_LOCAL_SECRETS 覆盖该路径。

通过受保护的 stdin 安装或轮换存储的凭据，使值不进入 shell 历史记录：

node bin/install-credentials.mjs < /path/to/private-credentials.json
npm run credentials

支持的 JSON 键：

{
  "openstatesApiKey": "provider-issued value",
  "nycLegistarToken": "provider-issued value"
}

推荐工作流程

1. 调用 list_jurisdictions 选择官方路线。

2. 使用 scan_official_source、search_openstates_bills 或 search_nyc_legistar_matters 收集线索。

3. 使用 record_discovery_candidate 记录合理的官方来源法案。

4. 审查每个候选，并调用 review_candidate 并传入 accept 或 reject。

5. 使用 record_measure_observation 记录官方观察。

6. 使用 get_due_reviews 和 get_exceptions 进行计划性跟进。

工具

• get_server_health

• list_jurisdictions

• scan_official_source

• search_openstates_bills

• search_nyc_legistar_matters

• record_discovery_candidate

• list_discovery_candidates

• review_candidate

• import_normalized_watchlist

• list_watchlist

• record_measure_observation

• dedupe_watchlist_measures

• record_exception

• resolve_exception

• get_due_reviews

• get_exceptions

• verify_event_log

开发

npm test
npm run smoke
npm run syntax