Familysearch

🚀 家族搜索 MCP 服務器

這是一個用於 FamilySearch API 的 Model Context Protocol (MCP) 服務器，它能讓 Claude 或 Cursor 這類 AI 工具直接與 FamilySearch 的家族歷史數據交互，為家族歷史研究帶來便利。

🚀 快速開始

本服務器允許 AI 工具與 FamilySearch 家族歷史數據交互。使用前，需完成服務器安裝與 FamilySearch API 設置，配置好憑證後即可運行服務器進行交互。

✨ 主要特性

• 使用 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 的人員信息

以 4 代的方式獲取 ID 為 ABCD-123 的祖先

搜索姓氏為 "Johnson"、出生地為 "England"、死亡日期為 "1880-01-01" 的記錄

📚 詳細文檔

安全提示

⚠️ 重要提示

您的 FamilySearch 憑證存儲在本地機器上的 ~/.familysearch-mcp/config.json 文件中。請勿與他人分享此文件。

📄 許可證

ISC