Cheap Research v1.0.0

境界付き証拠レビューエンジン。主張とドキュメントコーパスを与えると、関連する証拠を抽出し、矛盾を検出し、監査可能な証拠パケットを作成します。ハルシネーションなし、グローバルな真実の主張なし、オープンウェブ検索なし。

機能

1. 取り込み: PDF, TXT, MD, DOCX, DOC, HTML, RTF, EPUBドキュメント

2. 抽出: 主張に関連する証拠範囲

3. 検出: 主張とコーパス間の矛盾

4. レンダリング: 注意書き付きのマークダウン証拠パケット

5. 監査: 不変のハッシュチェーン監査証跡

信頼の姿勢

• フェイルクローズ - 強制エンジンが無効な権限移行をブロック

• 境界付きコーパス - 提供されたドキュメント外の主張は不可能

• 明示的な注意書き - すべてのパケットに制限事項を記載

• グローバルな真実の否定 - 「偽」ではなく「コーパス内で確立されていない」と判断

• 人間によるレビュー必須 - 主張には明示的なレビュアーの承認が必要

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アシスタントへの追加

このサーバーはModel Context Protocol (MCP)を使用しています。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