Clearon Legislation Monitor MCP

MCP-сервер для обнаружения законодательства США с обязательной проверкой и мониторинга списка наблюдения.

Он отделяет перспективные находки от подтверждённых записей списка наблюдения, фиксирует наблюдения и исключения в режиме append-only и не исключает проверку официальных источников из процесса до того, как акт становится авторитетным.

Что делает

• Записывает кандидатов на обнаружение, не продвигая их молча в список наблюдения

• Требует явной проверки человеком перед принятием в список наблюдения

• Отслеживает наблюдения официальных источников, предстоящие проверки и исключения при получении данных

• Воспроизводит журнал событий append-only в восстанавливаемый снимок состояния

• Опционально использует Open States и NYC Legistar как вспомогательные средства для поиска, но никогда как окончательное подтверждение

Related MCP server: universal-research-mcp

Что он не делает

• Он не публикует контент и не изменяет WordPress

• Он не рассматривает совпадение по ключевым словам как юридическое подтверждение

• Он не рассматривает результаты стороннего поиска как статус официального источника

• Он не превращает сбои получения данных в изменения юридического статуса

Требования

• Node.js 20 или новее

• Локальный MCP-клиент, который может запустить stdio-сервер

Установка

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