FamilySearch MCP 服务器

这是一个用于 FamilySearch API 的模型上下文协议 (MCP) 服务器。它允许像 Claude 或 Cursor 这样的 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 Developers
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 用户名和密码进行身份验证：

使用用户名：your_username 和密码：your_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" 的人物

获取 personId：ABCD-123 的人物

获取 personId：ABCD-123 的祖先，代数：4

搜索姓氏： "Johnson" 出生地： "England" 死亡日期： "1880-01-01" 的记录

安全提示

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

许可证

ISC