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. 각 후보를 검토하고 accept 또는 reject와 함께 review_candidate를 호출하세요.

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