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