AI Legal Watch MCP

CSV로 저장된 AI 법률 동향 추적기를 추가 전용(append-only) 방식으로 유지 관리하기 위한 MCP 서버입니다.

후보 행을 검증하고, 중복을 확인하며, 기존 CSV 형식을 보존하고, 직접 웹을 탐색하거나 법적 권위를 판단하지 않고 가능한 기사 후보의 순위를 매기는 데 도움을 줍니다.

하는 일

• 추적기 CSV를 읽고 필터링된 목록/다이제스트 뷰를 제공합니다

• 아무것도 쓰기 전에 후보 추가를 시뮬레이션(dry-run)합니다

• 추적기 지문이 여전히 일치할 때 승인된 행을 정확히 하나만 추가합니다

• 동시 추가를 방지하기 위해 잠금(lock)을 사용합니다

• 투명한 점수 매기기로 기사 후보를 제안합니다

Related MCP server: cv-builder

하지 않는 일

• 웹을 탐색하거나 법적 출처를 대신 검증하지 않습니다

• 기존 추적기 기록을 다시 쓰지 않습니다

• 허용되는 레거시 복구 범위를 넘어 기존 행을 조용히 병합하거나 정규화하지 않습니다

• 콘텐츠 아카이브를 요구하지 않으며, 구성된 경우 실패 시 개방(fail open)할 수 있습니다

요구 사항

• Node.js 20 이상

• stdio 서버를 실행할 수 있는 로컬 MCP 클라이언트

설치

cd tools/ai-legal-watch-mcp
npm install
npm test
npm run smoke

MCP 클라이언트 설정

stdio 구성 예시:

{
  "mcpServers": {
    "ai-legal-watch": {
      "command": "node",
      "args": ["/absolute/path/to/ai-legal-watch-mcp/server.mjs"],
      "env": {
        "AI_LEGAL_WATCH_WORKSPACE": "/absolute/path/to/workspace"
      }
    }
  }
}

추적기는 선택한 작업 공간에서 기본적으로 ai-legal-watch-tracker.csv를 사용합니다. 필요한 경우 AI_LEGAL_WATCH_TRACKER로 재정의하세요.

로컬 콘텐츠 아카이브를 사용하여 후보 제안에서 이미 다룬 행을 제외하려면 AI_LEGAL_WATCH_ARCHIVE_ROOT 또는 CLEARON_CONTENT_ARCHIVE_ROOT를 설정하세요.

안전 모델

• propose_tracker_update는 절대 쓰지 않습니다

• apply_tracker_update는 인코딩된 CSV 행을 하나만 추가하며 제안에서 반환된 정확한 SHA-256 지문을 요구합니다

• 추적기 잠금, 지문 확인, 중복 확인은 모두 잠금이 유지되는 동안 반복됩니다

• 기존 행은 재직렬화되지 않아 허용된 과거 형식의 특이성을 보존합니다

• 새 행은 게시 워크플로 레이블이 아닌 법적 분류를 사용해야 합니다

도구

1. list_watch_items

2. find_duplicate_development

3. propose_tracker_update

4. apply_tracker_update

5. generate_watch_digest

6. suggest_article_candidates

예제 워크플로

1. 주제, 개발 날짜, 공식 출처 URL과 함께 find_duplicate_development를 호출합니다.

2. 전체 후보 행과 함께 propose_tracker_update를 호출합니다.

3. 이 MCP 외부에서 기본 1차 출처와 법적 분류를 검증합니다.

4. 정확한 tracker_sha256과 변경되지 않은 candidate로 apply_tracker_update를 호출합니다.

5. 지문이 오래된 경우 이전 페이로드를 재시도하는 대신 새 제안을 생성합니다.

개발

npm test
npm run smoke
npm run syntax