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を介して行い、値がシェル履歴に残らないようにします:

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