chinese-history-mcp

chinese-history-mcp

追跡可能な中国史 MCP サーバーです。9 つの古典中国語テキスト（先秦から魏晋まで――史记／汉书／后汉书／三国志／左传／论语／孟子／吕氏春秋／资治通鉴）を対象とした、Model Context Protocol の 4 つのツールを提供します。すべての結果に【書籍 → 章 → 段落】の出典が付与されます。また、review_status を誠実に報告し、実施していない項目ごとの人手レビューを行ったとは決して主張しません。

イベント／人物／現代の地名／品質という4つの軸で、先秦から漢魏にかけての正史・子書9冊を検索できる、出典を追跡可能な中国史物語 MCP サーバーです。返されるすべての項目に原文の出典が付き、機械生成／機械レビュー済みの内容はその旨を正直に表示します。

• 実行時依存関係ゼロ — Python 標準ライブラリのみを使用します。フレームワークを pip install する必要も、MCP SDK も不要です。サーバー全体を少数のファイルで監査できます。
• 読み取り専用 — コーパスを mode=ro と PRAGMA query_only で開き、書き込みは一切行いません。
• 設計上、誠実 — 機械生成された句読点／翻訳と、機械判定されたステータスをすべての応答に明記します（AIGC 準拠）。

このプロジェクトの背景：2026年半ばの時点で、公開 MCP エコシステムには古典中国語／中国史を扱うサーバーがありません。このプロジェクトはその不足を補います。収益は一切見込んでいません。公共の利益に役立つものを作ることが目標です。

目次：4つのツール · インストールと実行 · コーパスデータベース · 誠実さ · データと出典 · 設計上の補足

4つのツール

各ツールの呼び出しは JSON を返します。複数の出典を持つイベント、人物評、場所／品質の関連には、すべて出典となった【書籍 → 章 → 段落】が正確に記載されます。それがこのサーバーの目的です。

インストールと実行

Python 3.9 以降が必要です（標準ライブラリのみで、ほかにインストールするものはありません）。 サーバーは stdio 経由で MCP と通信します（改行区切りの JSON-RPC 2.0）。

pip install chinese-history-mcp
# then (after downloading corpus.db from Releases — see below):
chinese-history-mcp --db /path/to/corpus.db

または、チェックアウトから直接、インストールせずに実行します。

PYTHONPATH=src python3 -m storyextractor.mcp.server --db /path/to/corpus.db

MCP クライアントでの設定

Claude Desktop（claude_desktop_config.json）、Cline、Continue などでは、stdio サーバーを 1 つ追加します。pip install chinese-history-mcp の実行後：

{
  "mcpServers": {
    "chinese-history": {
      "command": "chinese-history-mcp",
      "args": ["--db", "/path/to/corpus.db"]
    }
  }
}

{
  "mcpServers": {
    "chinese-history": {
      "command": "python3",
      "args": ["-m", "storyextractor.mcp.server", "--db", "/path/to/corpus.db"],
      "env": { "PYTHONPATH": "src" },
      "cwd": "/absolute/path/to/chinese-history-mcp"
    }
  }
}

ハンドシェイクを手動で試す

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{}}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"query_by_quality","arguments":{"quality":"忠","limit":2}}}' \
  | chinese-history-mcp --db /path/to/corpus.db

デモとハルシネーションの比較

python3 scripts/mcp_demo.py --db /path/to/corpus.db を実行すると、4 つすべてのツールを順に試せます（最小限の MCP クライアントの参考例も兼ねています）。同じ質問に対する 素の LLM（捏造／出典を引用できない）と、このサーバー（出典を引用できる） の比較については、docs/MCP_DEMO.md を参照してください。

コーパスデータベース

corpus.db はこのリポジトリには含まれていません（約 90 MB のバイナリファイルです）。このリポジトリの リリース からダウンロードし、--db で指定するか、STORYEXTRACTOR_DB=/path/to/corpus.db を設定してください。

データベースは実行時に読み取り専用です。読み取り専用の媒体でホストする場合は、リリース成果物が sqlite3 corpus.db "VACUUM INTO 'corpus_release.db'" によって生成されていることを確認してください（単一ファイルで、-wal／-shm のサイドカーファイルはありません）。

誠実さについて（お読みください）

このサーバーは、機械生成の出力を学術的成果として取り繕うのではなく、出典を明示することを目的としています。**下流のクライアントや LLM は、結果を「個別に人間が確認済み」として提示してはなりません。**各レスポンスには、その内容が明示されます。

• 出来事 review_status='approved' — 信頼できる推論の大部分は一括で機械承認されており、項目ごとに人間が確認したものではありません。
• 人物プロフィール review_status='draft' — LLM が合成したもので、人間による検証はされていません。
• 品質マッピング — auto_approved は複数の LLM による機械的な合意、draft はレビュー待ちです。evidence_quote は原文に実在する部分文字列で、rationale は LLM による推論です。
• 地名マッピング — 大部分は複数の LLM による機械的な合意（auto_approved）で、一部は人間が承認しています。信頼度は「高」「中」「疑わしい」に分類されています。
• テキスト — 原文はパブリックドメインの白文で、句読点と分かち書きは機械生成です。口語訳は全体が機械生成です。

また、このサーバーは下流でのハルシネーションをなくすものではありません。出典を引用できる検索事実を提供しますが、その上に構築された LLM が、それらをもとに虚構を生成する可能性は残ります。引用は、人間が検証するための手がかりです。

対象範囲は上記の 9 作品です。「見つからない」とは「このコーパスに含まれていない」という意味であり、「起きなかった」という意味ではありません。

データと出典

• 原文：パブリックドメインの古典中国語の白文（パブリックドメイン版に基づく句読点のない本文）に、独自に作成した機械生成の句読点と分かち書きを施したものです（現代の注釈版や校訂版からの転載ではありません）。
• 口語訳：コーパス全体を通して機械生成されています。
• 注釈（出来事／エンティティ／場所／品質）：機械支援で作成され、一部の層では人間によるレビューを承認の条件としています。ステータスはレコードごとに表示されます。

ライセンス

• コード（このリポジトリ）：MIT — LICENSE を参照してください。
• コーパスデータ（corpus.db、リリース経由で配布）：CC BY 4.0。

テキスト層はパブリックドメインの本文に独自の句読点と分かち書きを施したものなので、自由に配布されます。機械生成された属性には、AIGC のコンプライアンス対応として全体を通してラベルが付けられています。

設計上の注意点

• 標準ライブラリのみを使って手書きで実装した stdio JSON-RPC 2.0（initialize／tools/list／ tools/call と ping／通知）。サードパーティ製の MCP SDK は使用しません。
• DB へのアクセスは読み取り専用です（src/storyextractor/mcp/db.py）：mode=ro と PRAGMA query_only を使用します。マイグレーションを実行する db.connect は、サーブ時には決して使用しません。
• テスト：python3 tests/test_mcp_server.py（読み取り専用の強制、プロトコルの形式とエラーコード、 正確な review_status、エイリアスのトークン完全一致と曖昧性の解消、LIKE ワイルドカードのエスケープ） — 一時的なフィクスチャ DB を構築するため、 corpus.db がなくても実行できます。

コントリビューションとプロジェクト情報

• CONTRIBUTING.md — テスト／lint の実行方法と、このプロジェクトが重視する原則。
• CHANGELOG.md — リリース履歴。
• SECURITY.md — 脅威の対象範囲（読み取り専用、ネットワークアクセスなし）と、問題の報告方法。

Issue とプルリクエストを歓迎します。次の制約を念頭に置いてください： 実行時依存関係ゼロ、読み取り専用、すべての結果に出典を付けること、正確な review_status。