Familysearch

🚀 家族搜索 MCP サーバー

このサーバーは、FamilySearch API 用の Model Context Protocol (MCP) サーバーです。Claude や Cursor などの AI ツールが、直接 FamilySearch の家族歴データとやり取りできるようにします。

🚀 クイックスタート

家族搜索 MCP サーバーを使用することで、AI ツールが FamilySearch の家族歴データと直接やり取りできるようになります。以下の手順に従って、サーバーをセットアップして使用してください。

✨ 主な機能

• FamilySearch の認証情報を使用した認証
• FamilySearch の家族樹で個人記録を検索
• 個人情報の詳細を表示
• 個人の祖先と子孫を探索
• 履歴記録を検索

📦 インストール

前提条件

• Node.js 16+ と npm
• FamilySearch の開発者アカウントと API 認証情報
• 家族樹データにアクセスできる FamilySearch ユーザーアカウント

インストール手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

FamilySearch API の設定

このツールを使用する前に、FamilySearch API のアクセス権を登録する必要があります。

1. FamilySearch 開発者にアクセスします。
2. あなたの FamilySearch アカウントでログインします。
3. 新しいアプリを作成します。
4. リダイレクト URI を https://localhost:8080/oauth-redirect に設定します（後で変更可能）。
5. クライアント ID をコピーし、設定に使用します。

💻 使用例

基本的な使用法

サーバーを起動します：

npm start

その後、MCP をサポートする AI ツール（Claude や Cursor など）で、FamilySearch ツールを使用して家族歴データと直接やり取りできます。

高度な使用法

設定

初めて MCP を使用するときは、FamilySearch API の認証情報を設定する必要があります：

clientId: YOUR_CLIENT_ID_HERE を使用して FamilySearch API の認証情報を設定する

その後、あなたの FamilySearch ユーザー名とパスワードで認証します：

username: あなたのユーザー名 と password: あなたのパスワード を使用して FamilySearch にログインする

ログインに成功すると、認証情報は ~/.familysearch-mcp/config.json に安全に保存され、将来使用できます。

利用可能な MCP ツール

基本機能

• say-hello：簡単な挨拶関数
• configure：FamilySearch API の認証情報を設定する
• authenticate：FamilySearch にログインする
• get-current-user：あなたの FamilySearch アカウントの詳細を表示する

家族樹ツール

• search-persons：FamilySearch の家族樹で個人を検索する
• get-person：特定の人物の詳細情報を表示する
• get-ancestors：ある人物の祖先を表示する（最大 8 世代）
• get-descendants：ある人物の子孫を表示する（最大 3 世代）

履歴記録ツール

• search-records：FamilySearch の履歴記録を検索する

サンプルクエリ

名前が "John Smith" で、出生地が "New York" の人物を検索する

ID が ABCD-123 の人物の情報を取得する

ID が ABCD-123 の人物の 4 世代分の祖先を取得する

姓が "Johnson" で、出生地が "England"、死亡日が "1880-01-01" の記録を検索する

📚 ドキュメント

セキュリティに関する注意事項

あなたの FamilySearch 認証情報は、ローカルマシンの ~/.familysearch-mcp/config.json に保存されます。このファイルを他人と共有しないでください。

ライセンス

このプロジェクトは ISC ライセンスの下で提供されています。