Cheap Research v1.0.0

제한된 증거 검토 엔진입니다. 주장과 문서 말뭉치(corpus)를 제공하면 관련 증거를 추출하고, 모순을 감지하며, 감사 가능한 증거 패킷을 생성합니다. 환각, 전역적 진실 주장, 오픈 웹 검색은 없습니다.

기능

1. 수집(Ingest) PDF, TXT, MD, DOCX, DOC, HTML, RTF, EPUB 문서

2. 추출(Extract) 주장에 관련된 증거 범위

3. 감지(Detect) 주장과 말뭉치 간의 모순

4. 렌더링(Render) 주의 사항이 포함된 마크다운 증거 패킷

5. 감사(Audit) 변경 불가능한 해시 체인 감사 추적

신뢰 상태

• Fails closed - 시행 엔진이 유효하지 않은 권한 전환을 차단

• 제한된 말뭉치 - 제공된 문서 외부의 주장을 생성할 수 없음

• 명시적 주의 사항 - 모든 패킷은 제한 사항을 명시함

• 전역적 진실 없음 - "거짓"이 아닌 "말뭉치에서 확인되지 않음"으로 처리

• 인간 검토 필수 - 주장은 명시적인 검토자의 승인이 필요함

MCP 도구

빠른 시작: 논문 다운로드

corpus_load를 사용하여 큐레이팅된 기초 ML 논문 세트를 다운로드하세요:

// Download ALL papers to your corpus
corpus_load({ corpus_path: "/path/to/cheap-research/corpus" })

// Or download specific topics
corpus_load({
  corpus_path: "/path/to/corpus",
  topics: ["transformers", "optimization"]
})

// Or specific papers by ID
corpus_load({
  corpus_path: "/path/to/corpus",
  paper_ids: ["attention", "bert", "resnet"]
})

사용 가능한 주제: transformers, foundations, optimization, reinforcement, generative, representations, efficiency

포함된 논문: Attention Is All You Need, BERT, GPT, GPT-3, ResNet, AlexNet, LSTM, Adam, Batch Norm, Dropout, GANs, VAE, Diffusion Models, Vision Transformer, Word2Vec, DQN, Knowledge Distillation 등 (총 22편).

설치

git clone https://github.com/your-org/cheap-research.git
cd cheap-research
npm install
npm run build

AI 어시스턴트에 추가하기

이 서버는 MCP(Model Context Protocol)를 사용합니다. AI에 연결하는 방법은 다음과 같습니다:

Claude (Claude Code CLI / Claude Desktop)

1. MCP 설정 파일을 엽니다:

   • Claude Code: ~/.claude.json

   • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows)

2. mcpServers에 서버를 추가합니다:

{
  "mcpServers": {
    "cheap-research": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/cheap-research/node_modules/.bin/tsx",
        "--tsconfig",
        "/ABSOLUTE/PATH/TO/cheap-research/tsconfig.base.json",
        "/ABSOLUTE/PATH/TO/cheap-research/apps/mcp-server/src/index.ts"
      ]
    }
  }
}

3. /ABSOLUTE/PATH/TO/를 저장소를 복제한 실제 경로로 바꿉니다.

4. Claude Code 또는 Claude Desktop을 재시작합니다.

5. Claude Code에서 /mcp를 입력하여 서버가 연결되었는지 확인합니다.

기타 MCP 호환 AI 도구

MCP를 지원하는 모든 AI 도구는 이 서버를 사용할 수 있습니다. npm run mcp 명령을 실행하도록 설정하거나 위의 설정 형식을 사용하세요. 도구의 MCP 서버 설정 문서를 확인하세요.

MCP 서버로 실행 (수동)

npm run mcp

이 명령은 MCP 클라이언트를 위해 stdio 모드에서 서버를 시작합니다.

예시

// Start research on a claim
research_start({
  task_type: "bounded_doc_claim_assessment",
  target_claim: "Attention mechanisms enable Transformers to model long-range dependencies",
  entity: "Transformer architecture",
  feature: "attention mechanism",
  scope: "Assess based on provided neural network papers",
  corpus_path: "/path/to/corpus"
})

// Returns: { run_id, status: "completed", assessment: "qualified", ... }

지원되는 형식

포함되지 않은 기능 (의도적)

• 오픈 웹 검색

• 자율적 권장 사항

• 신뢰도 점수

• 자유 형식의 LLM 합성

• 자동 운영 승인

• 벡터 임베딩 / 의미론적 검색

아키텍처

corpus/           → ingestCorpus() → MemoryStore
                                  ↓
claim + evidence  → findRelevantSpans() → scored spans
                                  ↓
                  → detectContradictions() → flagged spans
                                  ↓
                  → createClaimCandidate() → enforcement check
                                  ↓
                  → renderPacketMarkdown() → evidence packet
                                  ↓
                  → publishPacket() → audit log

상태 머신

주장, 결과, 패킷 모두 시행 엔진에 의해 강제되는 엄격한 상태 전환을 가집니다. 불법적인 전환은 명시적인 차단기로 차단됩니다.

감사 추적

해시 체인으로 연결된 변경 불가능한 감사 로그입니다. 모든 작업은 다음 항목과 함께 기록됩니다:

• 행위자 컨텍스트 (누가)

• 객체 참조 (무엇을)

• 이벤트 유형 (작업)

• 페이로드 (세부 정보)

• 체인 해시 (무결성)

라이선스

MIT