Frame Check

문서가 보여주지 않는 부분을 확인하세요.

Frame Check는 구조적 프레이밍 분석 도구입니다. 문서가 취하는 관점, 누락된 관점, 그리고 독자를 어떻게 위치시키는지 명시합니다. 수치적 주장은 가능한 경우 권위 있는 출처와 대조하여 교차 검증합니다.

빠른 시작 (MCP 서버)

PyPI 패키지 frame-check-mcp는 Model Context Protocol 서버입니다. 로컬에서 실행되며 모든 MCP 호환 AI 클라이언트(Claude Desktop, Cursor, Cline, Continue.dev 등)에 결정론적 구조적 프레이밍 분석 도구를 제공합니다.

pip install frame-check-mcp

그런 다음 MCP 클라이언트를 설치된 진입점에 연결하십시오. Claude Desktop의 경우 claude_desktop_config.json에 다음을 추가하십시오:

{
  "mcpServers": {
    "frame-check": {
      "command": "frame-check-mcp"
    }
  }
}

클라이언트를 재시작하십시오. 그 후 대화 중에 "이 문서를 프레임 체크해 줄래?"라고 요청하세요. 전체 설치 및 검증 세부 정보는 MCP_SERVER.md에 있습니다.

Related MCP server: Analysis MCP

기능

문서를 전달하면 Frame Check는 다음을 반환합니다:

• 구조적 프레이밍 프로필: 5가지 분석적 관점(원인, 위험, 이해관계자, 트렌드, 불확실성) 중 문서가 다루는 내용, 누락된 내용, 그리고 각 관점의 밀도.

• 어조 및 인식론적 태도: 문서가 독자를 어떻게 위치시키는지, 그리고 주장의 몇 퍼센트가 출처에 귀속되는지.

• 시간적 지향성: 문서가 결론의 근거를 과거 데이터, 현재 상태, 또는 예측 중 어디에 두는지.

• 프레임 어휘 표준(Frame Vocabulary Standard) 후보 일치: 텍스트에서 규칙 기반 신호가 작동하는 명명된 프레임 패턴으로, 각각 식별 단서와 예시가 포함됩니다. 일치는 후보 수준이며, 다중 출처 라벨링에 대한 정밀도는 현재 활발히 연구 중인 주제입니다.

• 출처 네트워크 검증: SEC EDGAR, FRED, 세계은행, REST Countries, Alpha Vantage, Wolfram Alpha 등 해당 제공자가 커버리지를 보유한 경우 수치적 주장을 확인합니다.

• 선택적 AI 서술: 산문 수준에서 프레이밍을 해석합니다. 독자가 언어 모델의 해석과 결정론적 측정을 혼동하지 않도록 명확하게 라벨이 지정됩니다.

접근 방식

구조적 측정이 기본입니다. 도구가 수행하는 모든 프레이밍 주장은 결정론적 패턴 매처에서 계산되며 항상 동일한 입력에 대해 동일한 결과를 반환합니다. API 키가 구성된 경우 AI 보조 해석을 강화 요소로 사용할 수 있지만, 이는 별도로 라벨이 지정되며 구조적 계층 뒤에 숨겨지지 않습니다.

검증은 제한적입니다. 이 도구는 해당 주장 유형에 대해 실제 커버리지를 가진 제공자와 대조하여 수치적 주장만 검증하며, 증거 없이 결론을 단정하는 대신 자체 보정 결과(제공자별 정밀도, 재현율, F1)를 표면화합니다.

명명된 패턴 탐지는 구조적 프로필과는 별도의 신뢰성 계층입니다. 사전 등록된 검증에서 전문가 라벨러 대비 탐지기 F1 점수는 0.36으로, 유용한 임계값인 0.4 미만입니다. v0에서는 확신에 찬 라벨 대신 구성적 정직성 표면화(미탐지 마커, 밀도 주의사항, 신뢰 상태)로 전환하는 것이 핵심 주장입니다. 독자 지원 연구(Track B, 사전 등록)는 이러한 표면화가 독자가 놓칠 수 있는 프레이밍을 확인하는 데 실제로 도움이 되는지 테스트합니다.

정직한 한계와 예상되는 반대 의견은 ANTICIPATED_CRITIQUES.md에 정리되어 있습니다.

문서

• METHODOLOGY.md — 전체 방법론 논문 (v0.2 초안)

• MCP_SERVER.md — MCP 서버 참조 (도구, 리소스, 프롬프트)

• MCP_CLIENT_CONFORMANCE_v1.md — 설치된 휠에 대한 32/32 적합성 라운드 트립

• FRAME_DIVERGENCE_v1.md 및 FRAME_DIVERGENCE_v2.md — 다이버전스 아키텍처

• data/frame_library/ — 예시가 포함된 20개 항목의 FVS 카탈로그

• ANTICIPATED_CRITIQUES.md — 자체 열거된 반대 의견

• VALIDATION_PROGRAM.md — 관찰 및 공식 검증 계획

테스트 실행

pip install -r requirements.txt
python3 run_tests.py

49개 테스트 스위트, 약 3분 소요. test_mcp_adversarial.py의 63개 적대적 디스패처 테스트와 V4.2 엔진 + 분류기 커버리지가 포함됩니다.

라이선스

코드는 Apache-2.0; FVS 라이브러리 및 예시는 CC-BY-4.0 (디렉토리별 열거는 NOTICE 참조).

인용

Frame Check가 귀하의 작업에 유용하다면 인용 가능한 형식은 CITATION.cff를 참조하십시오. Frame Check는 Lovro Lucic이 저술했습니다. 구성적 정직성 원칙에 따라 명명된 저자 표시는 프로젝트의 주요 신뢰 자산입니다.

기여

CONTRIBUTING.md에 따라 DCO 서명이 필요합니다. 거버넌스는 GOVERNANCE.md를 따릅니다(표준 승인 결정을 위한 명명된 강제 기능을 갖춘 BDFL 모델). 외부 검토자 참여는 REVIEWERS.md를 참조하십시오.

이슈

https://github.com/lluvr/frame-check-mcp/issues