Genealogy research toolkit

genealogy-mcp — あらゆる AI アシスタントで家族の歴史を調べる

ロシア語版

MCP サーバーです。Claude、ChatGPT、Cursor、または MCP に対応するあらゆるアシスタントを、慎重な系図調査者にします。祖先の記録がどこにあるか（ロシアと旧ソ連、ヨーロッパ、ブリテン諸島、米国、ラテンアメリカにまたがる171の公文書館とデータベース）、どのように検索するか（名前の異表記、音訳、旧綴り、ユリウス暦）、そして見つかった人物が本当にあなたの祖先なのかを把握しているため、アシスタントは自信満々の推測ではなく、実際に使えるリンクと調査計画を提示します。

gene_archive を活用したオープンな家族アーカイブのために、長年にわたる実際の調査をもとに構築しました。教会の洗礼・婚姻・埋葬記録、徴兵名簿、第一次・第二次世界大戦のデータベース、弾圧関連の記録、移民記録など、そして調査の過程で遭遇したあらゆる落とし穴を反映しています。その背景については、Habrの記事をご覧ください（ロシア語）。

概要

• 55か国にある171の公文書館とデータベース。それぞれの所蔵内容と、効果的な検索方法を案内します。また、歴史的な州の記録を現在どの公文書館が所蔵しているかもわかります（国境は移動しており、答えは一見して明らかな場所とは限りません）。
• 系図調査の実務に役立つ31のツール：名前の異表記と9種類の音訳方式、ダイチ＝モコトフ符号、ユリウス暦・ヘブライ暦・フランス共和暦、教会の祝祭日による日付、教会スラヴ語の数字、3言語での親族関係、DNA、証拠の確認、系図の監査、公開データベースでのライブ検索、公文書館への問い合わせ文案。
• 系図を横に置くのではなく、系図そのものを使って作業します。 MyHeritage、Ancestry、Gramps、RootsMagic の .ged ファイルを指定すると、ファイルをその場で読み取り、検索し、変更します。変更した行だけを書き換え、それ以外はバイト単位で保持し、コピーを保存したうえで、変更内容を事前にすべて表示します。また、gene-archive の家族向けウェブサイトを指定することもできます。その場合、変更はサイトのチェック、ログ、Git 履歴を通して反映されます。
• 調査内容を記憶します。 完全な引用情報付きの資料、未解決の手がかり、すべての検索（「何も見つからなかった」場合も含む）を記録するため、同じ場所を二度検索することはありません。
• 誠実さを設計に組み込んでいます。 同姓同名の人物は親族とは限りません。名前以外に、互いに独立した事実が2つ確認できた場合にのみ、見つかった人物を関連付けます。
• プライバシーを重視します。 お使いのコンピューター上で動作し、オンラインに接続するのは依頼された検索を行うときだけで、その検索先も指定された1つのサイトに限られます。
• あらゆるアシスタントに対応： Claude Desktop（ワンクリックでインストール）、Claude Code、ChatGPT、Cursor、VS Code、Windsurf、Cline。
• 英語、ロシア語、ウクライナ語のガイドを用意しています。主要なガイドはスペイン語、ポルトガル語、ポーランド語、ドイツ語でも利用できます。

クイックスタート

Claude Desktop： 最新リリースから genealogy-mcp-<version>.mcpb をダウンロードして開きます。 Claude Code： claude mcp add genealogy -- uvx genealogy-mcp。 その他： サーバーコマンドとして uvx genealogy-mcp を使用します（詳細はインストールをご覧ください）。

あとは、次のように尋ねるだけです。「曾祖父を探すのを手伝ってください。わかっていることは……」

質問できること

曽祖父のIvan Kolodinは、1885年ごろトゥーラ県のボゴロジツク近郊で生まれました。どこを探せばよいですか？

アシスタントはロシアの1880～1945年を対象に計画を立て、記録ガイドを読み、名前の異形（Колодин / Колодина / Колодинъ / Kolodin / Kołodin…）を作成し、FamilySearch、Internet Archiveの全文検索、ロシアの戦争関連データベースへの検索リンクを提示します。どのアーカイブに教区簿が所蔵されているかを伝え、問い合わせ文案も作成します。

この洗礼記録は同じIvanのものでしょうか？「Іоаннъ, отец Петръ, 1887, Сынково」と書かれています。

check_match は名前の異形と年齢の許容範囲を考慮しながら、事実を一つずつ比較します。名前以外に独立した事実が2つあれば「確認済み」、1つなら「可能性あり」、矛盾があれば3つ目の資料を探すよう提案します。

祖母のいとこの娘は、私から見て何にあたりますか？ И как это по-русски?

kinship → 「троюродная сестра… / first cousin once removed」—ロシア語、英語、ルーマニア語での呼び方と、予想されるDNA共有率を示します。

家系図を確認してください。（Ancestry、MyHeritage、Gramps、Geni…のGEDCOM）

audit_tree はあり得ない点（母親の死亡後に生まれている、母親が10歳、出生前に死亡している）、重複の可能性、空白を見つけ、次の調査に向けたToDoリストを作成します。

記録には1885年の「на Покров」に生まれたとあり、年は҂аѡ҃пеと記されています。

cyrillic_numerals が年（1885年）を読み取り、feast_date が10月1日（ユリウス暦）＝1885年10月13日と示します。

MyHeritageで一致した人と230 cMを共有しています。彼女は私とどのような関係でしょうか？

dna_match は、はとこ、いとこ違い2世、半いとこなどの可能性と、最終的には書類でしか判断できない理由を示します。

ヴォルィーニ県の教区簿は現在どこにありますか？

where_are_records は、ジトーミル州立文書館（教区参事会）、リウネ、ヴォルィーニの各アーカイブを示します。国境は変わっているため、必ずしも現在の地域のアーカイブにあるとは限りません。

見つけたことを覚えておいて、来週続きを調べてください。

お使いのコンピューター上の調査プロジェクトです。人物、完全な引用情報を含む資料、未解決の手掛かり、調査ログをすべて保存します。「何も見つからなかった」という記録も残すため、同じ場所を二度探さずに済みます。GEDCOMのインポートとエクスポートに対応しています。

見つけたことを家族のサイトに書き込んでください。

ご家族のアーカイブがgene-archiveサイトなら、プロジェクトツールにそのフォルダーのパスを指定してください。アシスタントはアーカイブ自体を読み取り、誰が登録されていないか、どの日付に資料がないかを確認します。変更はすべてサイト独自のチェックを経て、訂正ログと調査ログに記録され、あなたの名前でgitにコミットされ、サイトが再構築されます。変更内容を先に表示し、あなたが承認した後にのみ書き込みます。

この家系図に、見つけたことを追加してください。

または、MyHeritage、Ancestry、Gramps、RootsMagic、Family Historian、webtreesで管理している家系図のGEDCOMファイルを渡してください。アシスタントはファイルを読み取り、検索し、ファイルを直接変更します。変更された行だけを書き換えるため、お使いのプログラム独自のタグ、写真、メモ、ヘッダーはバイト単位でそのまま保持されます。書き込み前に変更行を表示し、ファイルのコピーを保存し、調査ログ、手掛かり、訂正内容をファイルと同じ場所に保存します。その後、ファイルをお使いのプログラムにインポートしてください（Family HistorianとwebtreesはGEDCOMを直接扱えます）。UTF-8以外のファイルは読み取り専用です。

これを使う理由

これを使わない場合	genealogy-mcp を使う場合
アシスタントは有名なウェブサイトを2、3件挙げます	国、年代、記録の種類で選べる171の情報源。それぞれに「上手な検索方法」があります
1つの綴りで検索します	綴りの異形、1918年以前の正書法、男性形・女性形、9種類の翻字方式、名の異形（Иван = Іоаннъ = Jan = Johann = Juan）
URLをでっち上げたり、壊れたURLを示したりします	テスト済みのURLテンプレートで作成したすぐ使える検索リンク。毎週のジョブですべてのサイトを確認します
「この人はおそらくあなたの祖先です」と言います	明確な証拠のルールがあります。同姓同名の人は親族ではありません
日付をそのまま受け入れます	ユリウス暦 ↔ グレゴリオ暦、年齢から算出した出生年の現実的な誤差、GEDCOM 形式に正規化した日付
一般的なアドバイスしかありません	記録ガイド：教区簿、告解者名簿、徴兵名簿、世帯簿、第一次・第二次世界大戦、弾圧関連ファイル、乗客名簿、国勢調査、ヨーロッパの民事登録、ラテンアメリカの記録
アーカイブへの問い合わせを一から書きます	ロシアのZAGS、国立・軍事・FSBアーカイブへの問い合わせ文案、および英語、スペイン語、ポルトガル語による任意のアーカイブへの問い合わせ文案
チャットのたびに情報を忘れます	人物、情報源、手がかり、すべての検索を記憶する調査プロジェクト
あなたの家系図に手を加えられません	あなた自身のGEDCOMファイルをその場で読み込み、変更します。情報を失わず、変更内容はすべて事前に表示します
古い数字や日付を読み取れません	教会スラヴ語の数字、教会の祝日、ユリウス暦、ヘブライ暦、フランス共和暦
「FamilySearchで名前を検索してください」と言います	Internet Archiveの全文、WikiTree、Open Archives、Wikidataの場所の履歴をライブ検索します
DNAマッチの関係が分かりません	共有cM値 → その値に当てはまる続柄

多くの系譜調査用MCPサーバーは、アシスタントを1つのサービスまたは1つのファイルに接続します。genealogy-mcpは、どこを探すか、どう検索するか、見つけた情報をどう読み取り評価するかという調査手法も提供し、あなた自身の家系図ファイルにも対応します。FamilySearchクライアントなど、利用中のサービス向けサーバーと一緒に問題なく実行できます。

すべての処理はあなたのコンピューター上で行われます。サーバーがオンラインに接続するのは、アシスタントがライブ検索（search_online、search_book_pages、place_history）を実行するときだけで、その場合もクエリは対象のサイト1つにだけ送信されます。

対応範囲

• 全世界： FamilySearch（記録および索引未作成画像のカタログ）、Internet Archive の全文検索、MyHeritage、 Geni、WikiTree、Find a Grave、BillionGraves、Arolsen Archives、Yad Vashem、JewishGen、Matricula、Geneanet、Wikipedia。
• ロシアとソ連： Yandex Archive、アーカイブ案内、VGD フォーラム、Pamyat Naroda、OBD Memorial、gwar.mil.ru、 Road of Memory、Immortal Regiment、Open List、Immortal Barrack、Returned Names、PSTGU martyrs、NashiPredki、 metricabook.ru、Rodovod、大統領電子図書館および国立電子図書館、歴史図書館、古地図、教会史、RIA-1914、 地域アーカイブ、ZAGS、TsAMO、RGVIA、RGIA、GARF。
• ウクライナ、ベラルーシ、モルドバ、ルーマニア、ポーランド、バルト諸国： 国立アーカイブのポータルとカタログ、TsDIAK、 genealogica.ro、Genealogy of Bessarabia、deportari.org、Cartea Memoriei、1772～1774年のモルダヴィア国勢調査、 Geneteka、Szukajwarchiwach、epaveldas、Raduraksti、エストニアのアーカイブ。
• ヨーロッパ： 第一次世界大戦のICRC捕虜記録、CWGC、Volksbund、ScotlandsPeople、FreeBMD、アイルランドの民事記録および国勢調査記録、Archion、 GenWiki、FranceArchives、Mémoire des hommes、Antenati、PARES、Digitarq、Open Archives（NL）、ベルギー国立公文書館、 Riksarkivet、Digitalarkivet、Danish Family Search、HisKi、フィンランドデジタルアーカイブ、Hungaricana、Acta Publica（チェコ）、 ブルガリア国立公文書館、FreeCEN、FreeREG、The National Archives、GRO、ウェールズ新聞。
• ドイツおよびドイツ語圏： 第一次世界大戦の戦死者名簿、GEDBAS、Online-OFB、ドイツデジタル図書館、Bundesarchiv、 バルト人名辞典、黒海ドイツ人（Odessa3）、Poznań Project、Metryki。
• ユダヤ系の系譜調査： JRI-Poland、Gesher Galicia、LitvakSIG、JewishGen、Yad Vashem、Steve Morse One-Step ツール。
• コーカサスおよび中央アジア： ジョージア国立公文書館、カザフスタン、ウズベキスタン、 キルギス、タジキスタン、トルクメニスタンの中央国立公文書館。
• 南北アメリカ： FamilySearch Latin America、メキシコ国立公文書館（AGN）、ブラジル国立公文書館および移民博物館（Museu da Imigração）、 Hemeroteca Digital、CEMLAおよびアルゼンチン国立公文書館（AGN）、チリ国立公文書館（Archivo Nacional）、NARA、Ellis Island、Chronicling America、 USGenWeb、カナダ図書館・公文書館、BAnQ（ケベック州）、Pier 21。
• オーストラリアおよびニュージーランド： Trove、オーストラリア国立公文書館、Papers Past、ニュージーランドのBDM。

記録の調査ガイドは英語、ロシア語、ウクライナ語で提供されており、主要なものはスペイン語、ポルトガル語、ポーランド語、ドイツ語でも利用できます。

インストール

Claude Desktop、ワンクリック： 最新のリリースからgenealogy-mcp-<version>.mcpbをダウンロードして開きます。Claude Desktopがインストールし、調査プロジェクトの保存場所を尋ねます。

その他の方法では、uvが必要です（Pythonとパッケージを自動で取得します）。

Claude Desktop、手動： Settings → Developer → Edit Configを開き、次を追加します。

{
  "mcpServers": {
    "genealogy": {
      "command": "uvx",
      "args": ["genealogy-mcp"]
    }
  }
}

Claude Code：

claude mcp add genealogy -- uvx genealogy-mcp

Cursor（~/.cursor/mcp.json）、Windsurf、Cline — Claude Desktopと同じmcpServersブロックを使用します。 VS Code（.vscode/mcp.json）：{"servers": {"genealogy": {"command": "uvx", "args": [ …same… ]}}}。

Docker： docker build -t genealogy-mcp .を実行し、その後docker run -i --rm genealogy-mcp（stdio）または docker run --rm -p 8000:8000 genealogy-mcp --http --host 0.0.0.0（/mcpでHTTP）を実行します。

プロジェクトとしてgene-archiveサイトを使用する場合： gene-archiveと一緒にサーバーをインストールします。 pip install "genealogy-mcp[site]"またはuvx --from "genealogy-mcp[site]" genealogy-mcpを実行します（geneコマンドはPATH上、またはサーバーのPythonと同じ場所から見つかります。それ以外の場所にある場合はGENE_CMDを設定します）。次に、フォルダー名をGENEALOGY_MCP_SITES（またはClaude Desktopの拡張機能設定）に指定するか、アシスタントにパスを伝えてください。GENE_AUTHORはgit履歴に記録する名前を設定します（デフォルト：git config user.name）。

GEDCOMファイルのツリーをプロジェクトとして使用する場合： .gedファイルのパスをアシスタントに伝えます（またはGENEALOGY_MCP_SITESに指定します）。コピーはtree.ged.bak（直近の変更前）とtree.before-genealogy-mcp.ged（最初の変更前）として保存され、ログはtree.ged.research.jsonに保存されます。

HTTPで接続するクライアント（ChatGPTコネクター、リモートエージェント）：HTTPSの背後でgenealogy-mcp --http --host 0.0.0.0 --port 8000を実行し、https://your-host/mcpを追加します。 HTTPモードでは、audit_treeが受け取るのはGEDCOMテキストのみで、ファイルパスは受け取りません。

パッケージはPyPIと公式MCP Registry（io.github.igormel81/genealogy-mcp）で公開されています。uvx genealogy-mcpでインストールして実行できます。

調査ワークフロー

project_viewから始めます。ここではポリシー、ローカルソース、進行中の質問、担当者のタスクを確認できます。 家族の文書と戸籍記録から既存の記録、一次資料へと調査を進め、その後に二次資料から手がかりを探します。project_policyでは、プロジェクトごとに制限とアーカイブへの問い合わせに関する設定を行えます。手がかりには次のステップがあり、ソース確認では検索結果がなかった場合と、サイトにアクセスできなかった場合を区別します。site.jsonのないカスタムアーカイブフォルダーは、変換や変更をせずに読み取れます。ワークフロー、ポリシー、ソース確認を参照してください。

カタログには171件の項目がありますが、これは推奨情報であり、171個の稼働中コネクターではありません。6つのサービスがsearch_onlineに対応し、Wikidataは地名の歴史情報を提供します。その他のソースには、ブラウザーまたはユーザーから提供された文書が必要です。Gallicaのページ検索と出来事の証拠については、書籍と出来事の引用で説明しています。

ツール

ツール	機能
plan_research	国と期間を指定すると、記録の有無、ガイド、調査する情報源の順番を段階的に示します
find_sources	国・地域（europe、latin_america、russian_empire など）、年代、記録の種類から情報源を検索します
source_details	1つの情報源について、対象範囲、アクセス方法、検索方法を示します
where_are_records	歴史上の州（ロシア帝国、ポーランド、ガリツィア、ブコヴィナ、東プロイセン、バルト諸国、コーカサス）の記録を現在所蔵する公文書館を示します。年を指定すると、その当時の土地の帰属を示します（南ベッサラビア：1857～1878年はモルダヴィア／ルーマニア、1918～1944年はルーマニア）。村を指定すると、その台帳を保管していた教会を示します
search_links	名前とその異形を検索するための、すぐに使える検索 URL を生成します
search_online	インターネットアーカイブの全文、Chronicling America、WikiTree、Open Archives、Open List、Gallica の OCR 文書をリアルタイム検索します
place_history	Wikidata を使って、村の所属が時代ごとにどう変わったか、座標、Wikipedia の記事を示します。判明している場合は、村が属していた教会も示します
name_variants	綴り、旧正書法、性別による形式、翻字、Daitch–Mokotoff コード、名の対応形（イディッシュ語とヘブライ語を含む）、父称を示します。モルドバの姓については、ルーマニア語、ロシア語、ソビエト期のモルドバ語の形式を示し、2つ目の姓（«Мокану, он же Плеш»）にはフラグを付けます
normalize_date	「около 1899」、「9 de octubre de 1899」→ ABT 1899、9 OCT 1899
convert_calendar	ユリウス暦 ↔ グレゴリオ暦、ヘブライ暦、フランス革命暦を変換します
feast_date	«на Покров»、「ペトロフ断食の後」、イースター、Wielkanoc…を、指定した年の日付に変換します
cyrillic_numerals	҂аѡ҃п ↔ 1880
birth_year_from_age	記録の年齢から生年の範囲を推定します
estimate_birth_year	親族の情報（長子の誕生年 −27、配偶者やきょうだい ±8、両親 +18～+45）と年齢から生年を推定します。根拠の説明付きで BET … AND … / ABT … を示し、同一人物ではありえない年齢には、同姓同名の別人である可能性が高いとフラグを付けます
kinship	ru/en/ro で続柄の名称と、想定される DNA の共有率を示します
dna_match	共有 cM から、該当する続柄を示します（Shared cM Project 4.0）
check_match	見つかった記録が調査対象の人物のものか判定します。比較したすべての事実を示し、ヒスパニック系の複合姓も考慮します
parent_hypothesis	父称から親の仮説を立てます。名前、村、年齢に基づいて候補を順位付けし、賛成・反対の根拠（孫の名前、代父母、保証人など）、別の村の同姓同名者に関する警告、仮説を確定できる記録を示します。これは手がかりであり、確定的なつながりではありません
audit_tree	GEDCOM または family_tree.json 内の矛盾する事実、重複、欠落を調べます
project_view、project_save、project_log、project_transfer	会話をまたいで調査プロジェクト（人物、家族、情報源、手がかり、検索ログ、GEDCOM のインポート／エクスポート）を管理します。または、遺伝子アーカイブサイトのフォルダーをチェックとログを経て書き換えるか、独自の .ged ファイルをその場で変更します
search_book_pages	Gallica の書籍内の OCR 抜粋、スキャンの連番、固定ページリンクを示します
project_evidence	出来事ごとの出典記載状況、リンク切れの参照、欠落している位置情報を、世代ごとに優先順位付けして示します
project_policy	このプロジェクトの方針（進行中の質問の上限、公文書館への依頼文書、存命人物の調査、プロジェクト所有者のタスク）を示します
project_coverage	閲覧済みの記録を示します：教区 → 年 → 区分 → フィルムとコマ → 完了／No. … まで一部閲覧／未発見。また、対象の村と年代で未閲覧のものも示します
film_reading_plan	インデックスのない FamilySearch フィルムを1ページずつ読むための計画を作成します。フィルムの閲覧順、サムネイルと全コマの使い分け、レート制限内でのリクエスト予算、記録すべき内容を示します
draft_archive_request	戸籍登録所または公文書館への依頼文を作成します
record_guide	記録の種類ごとの読み方と見つけ方を説明します
glossary	古いロシア語の記録に使われる用語を解説します
リソース： genealogy://sources（カタログ）、`genealogy://guide/research/{en	ru}`（調査ガイド全文）、
`genealogy://guide/prompts/{en	ru}（各ステップですぐ使える依頼文）、genealogy://records/{topic}、genealogy://glossary`。
プロンプト： 調査を始める、発見内容を確認する、記録を転記する、アーカイブに問い合わせる。

プライバシーと誠実さ

• サーバーが独自に情報を外部へ送信することはありません。ライブ検索（search_online、search_book_pages、place_history）では、検索クエリ（氏名、 年、場所）が検索対象のサイトに送信されます。調査プロジェクトはお使いのコンピューター上のファイルです （~/Documents/genealogy-mcp または GENEALOGY_MCP_HOME）。共有 HTTP サーバーでは無効になります。
• ご利用のアシスタントは独立したサービスであり、独自のプライバシーポリシーがあります。存命の 人物に関する詳細を貼り付ける前によく考えてください。
• 手紙は下書きです。内容を確認してから送信してください。
• アシスタントに与えられるルール：原典を引用する、矛盾する複数の記述を残す、推測には「おそらく」と明記する、証拠なしに同姓同名の人物を結びつけない。

ベンチマーク

evals/tasks.json には、確認可能な答えがある35の質問が含まれています。教会の祝祭日による日付、ユリウス暦、ヘブライ暦、共和暦、 キリル数字、Daitch–Mokotoff、モルドバの姓、DNA、親族関係、古い用語、歴史的な 州のアーカイブと年ごとの国境、証拠の確認、同一人物ではありえない年齢、 記録の変遷などが対象です。evals/check_tools.py は CI で実行され、ツールがすべての質問に正しく答えることを確認します。 evals/run.py はサーバーなしとサーバーありの両方で同じ質問を Claude モデルに尋ね、両者を採点します （API キーが必要です。費用がかかるため、手動で実行します：Actions → Benchmark）。

貢献

ソースの項目と貢献ガイドラインについては、CONTRIBUTING.md をご覧ください。 ソースが見つからない、またはリンク先が変わりましたか？tools/make_sources.py を編集し、python3 tools/make_sources.py と python3 -m unittest discover tests を実行して、プルリクエストを作成してください。記録ガイドは src/genealogy_mcp/guides.py にあります。

関連項目

• gene_archive — 家系アーカイブサイト用のオープンソースエンジンです： 系図、物語、文書、地図、GEDCOM、オンラインエディター、親族からのコメントを備えています。

MIT ライセンス。