FamilySearch MCP 服务器

这是一个用于 FamilySearch API 的 Model Context Protocol (MCP) 服务器。它允许像 Claude 或 Cursor 这样的 AI 工具直接与 FamilySearch 的家谱数据进行交互。

功能

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

前提条件

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

安装

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

bash npm install

1. 构建项目：

bash npm run build

FamilySearch API 设置

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

1. 前往 FamilySearch 开发者页面
2. 使用您的 FamilySearch 账户登录
3. 创建一个新的应用程序
4. 将重定向 URI 设置为 https://localhost:8080/oauth-redirect（您可以稍后更改）
5. 复制您的 Client ID - 您将在配置时需要它

使用方法

运行服务器：

bash 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