# dulbrich
## 基本信息
- Slug: `dulbrich-familysearch-mcp`
- Source: modelscope
- Publisher: @dulbrich/familysearch-mcp
- Categories: search / documentation-access / research-and-data
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@dulbrich/familysearch-mcp
## 简介
暂无描述。
## MCP Server 详情

[![MseeP.ai 安全评估徽章](https://mseep.net/pr/dulbrich-familysearch-mcp-badge.png)](https://mseep.ai/app/dulbrich-familysearch-mcp)

# 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


3. 构建项目：

bash
npm run build


## FamilySearch API 设置

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

1. 前往 [FamilySearch 开发者页面](https://www.familysearch.org/developers/)
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