FamilySearch MCP 服务器

这是 FamilySearch API 的模型上下文协议 (MCP) 服务器。它允许 Claude 或 Cursor 等 AI 工具直接与 FamilySearch 的家族历史数据进行交互。

特征

• 使用 FamilySearch 凭证进行身份验证
• 在 FamilySearch 家谱中搜索个人记录
• 查看详细人员信息
• 探索祖先和后代
• 搜索历史记录

先决条件

• Node.js 16+ 和 npm
• FamilySearch 开发者帐户和 API 凭证
• 可以访问 Family Tree 数据的 FamilySearch 用户帐户

安装

1. 克隆此存储库
2. 安装依赖项：

3. 构建项目：

FamilySearch API 设置

在使用此工具之前，您需要注册 FamilySearch API 访问权限：

1. 前往FamilySearch 开发者
2. 使用您的 FamilySearch 帐户登录
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 ：登录 FamilySearch
• get-current-user ：查看您的 FamilySearch 帐户的详细信息

家谱

• search-persons ：在 FamilySearch 家谱中搜索个人
• get-person ：查看特定人员的详细信息
• get-ancestors ：查看某人的祖先（最多 8 代）
• get-descendants ：查看某人的后代（最多 3 代）

历史记录

• search-records ：搜索 FamilySearch 的历史记录集合

示例查询

安全声明

您的 FamilySearch 凭据存储在您本地计算机的~/.familysearch-mcp/config.json文件中。切勿与他人共享此文件。

执照

国际学习中心