Clearon Legislation Monitor MCP

MCP-Server für die entdeckung und Überwachung von US-Gesetzgebung mit Review-Gate.

Er trennt Discovery-Leads von verifizierten Watchlist-Einträgen, protokolliert append-only Beobachtungen und Ausnahmen und hält die offizielle Quellenprüfung im Prozess, bevor eine Maßnahme maßgeblich wird.

Was es tut

• Erfasst Discovery-Kandidaten, ohne sie stillschweigend in die Watchlist zu übernehmen

• Erfordert eine explizite menschliche Prüfung vor der Watchlist-Aufnahme

• Verfolgt Beobachtungen aus offiziellen Quellen, fällige Prüfungen und Abrufausnahmen

• Spielt ein append-only Ereignisprotokoll in eine wiederherstellbare Momentaufnahme ab

• Verwendet optional Open States und NYC Legistar als Discovery-Helfer, niemals als endgültigen Beweis

Related MCP server: universal-research-mcp

Was es nicht tut

• Es veröffentlicht keine Inhalte und ändert WordPress nicht

• Es behandelt einen Keyword-Treffer nicht als rechtliche Verifizierung

• Es behandelt Ergebnisse von Drittanbieter-Discovery nicht als Status der Quelle

• Es wandelt Abruffehler nicht in Änderungen des Rechtsstatus um

Anforderungen

• Node.js 20 oder neuer

• Ein lokaler MCP-Client, der einen stdio-Server starten kann

Installation

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

MCP-Client-Einrichtung

Beispiel-stdio-Konfiguration:

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

Wenn sich Ihre normalisierten Tracker-Eingaben nicht an den Standard-Arbeitsbereichs-Speicherorten befinden, setzen Sie außerdem:

• CLEARON_LEGISLATION_REGISTRY_PATH

• CLEARON_LEGISLATION_WATCHLIST_PATH

Speicherung

Standardmäßig wird der Monitorstatus außerhalb des Repositorys in einem Benutzerdatenverzeichnis gespeichert:

• 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

Überschreiben Sie diesen Speicherort mit CLEARON_LEGISLATION_MONITOR_ROOT.

Die kanonischen Tracker-Eingaben werden weiterhin aus Ihrem gewählten Arbeitsbereich erwartet:

• trackers/state-legislation/jurisdictions.json

• trackers/state-legislation/watchlist.csv

sofern Sie sie nicht explizit mit Umgebungsvariablen überschreiben.

Anmeldedaten

Optionale Anbieterschlüssel können direkt in der Umgebung bereitgestellt werden:

• OPENSTATES_API_KEY

• NYC_LEGISTAR_TOKEN

Der Server unterstützt auch eine optionale lokale Secrets-Datei. Standardmäßig sucht er nach:

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

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

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

Überschreiben Sie diesen Pfad mit OPENCLAW_LOCAL_SECRETS.

Installieren oder rotieren Sie gespeicherte Anmeldedaten über geschütztes stdin, damit Werte nicht in der Shell-Historie landen:

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

Unterstützte JSON-Schlüssel:

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

Empfohlener Workflow

1. Rufen Sie list_jurisdictions auf, um die offizielle Route zu wählen.

2. Verwenden Sie scan_official_source, search_openstates_bills oder search_nyc_legistar_matters, um Leads zu sammeln.

3. Erfassen Sie plausible Maßnahmen aus offiziellen Quellen mit record_discovery_candidate.

4. Prüfen Sie jeden Kandidaten und rufen Sie review_candidate mit accept oder reject auf.

5. Erfassen Sie offizielle Beobachtungen mit record_measure_observation.

6. Verwenden Sie get_due_reviews und get_exceptions für geplante Nachverfolgungen.

Werkzeuge

• 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

Entwicklung

npm test
npm run smoke
npm run syntax