ファミリーサーチ MCP サーバー

これはFamilySearch API用のモデルコンテキストプロトコル（MCP）サーバーです。ClaudeやCursorなどのAIツールがFamilySearchの家族歴データを直接操作できるようになります。

特徴

• FamilySearch 資格情報による認証
• FamilySearchファミリーツリーで人物記録を検索する
• 詳細な人物情報を表示する
• 先祖と子孫を探る
• 履歴記録を検索する

前提条件

• Node.js 16+ および npm
• FamilySearch開発者アカウントとAPI認証情報
• ファミリーツリーデータにアクセスできるFamilySearchユーザーアカウント

インストール

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

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

ファミリーサーチ API セットアップ

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

1. ファミリーサーチ開発者サイトへ
2. ファミリーサーチアカウントでサインイン
3. 新しいアプリケーションを作成する
4. リダイレクト URI をhttps://localhost:8080/oauth-redirectに設定します (後で変更できます)
5. クライアントIDをコピーします - 設定に必要になります

使用法

サーバーを実行します。

次に、MCP をサポートする AI ツール (Claude や Cursor など) で、FamilySearch ツールを使用して家族歴データを操作できます。

構成

MCP を初めて使用するときは、FamilySearch API 資格情報を使用して設定する必要があります。

次に、FamilySearch のユーザー名とパスワードで認証します。

認証されると、資格情報は今後使用するために~/.familysearch-mcp/config.jsonに安全に保存されます。

利用可能なMCPツール

基本

• say-hello : シンプルな挨拶機能
• configure : FamilySearch APIの資格情報を設定する
• authenticate ：ファミリーサーチにログイン
• get-current-user : FamilySearch アカウントの詳細を表示する

家系図

• search-persons : FamilySearchファミリーツリーで個人を検索
• get-person : 特定の人物の詳細情報を表示する
• get-ancestors : ある人物の先祖（最大 8 世代）を表示する
• get-descendants : 人の子孫を表示する（最大 3 世代）

歴史的記録

• search-records : FamilySearch の歴史的記録コレクションを検索

クエリの例

セキュリティに関するお知らせ

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

ライセンス

ISC