FamilySearch MCP Server

基本能力

产品定位

FamilySearch MCP Server 是一个连接 AI 工具与 FamilySearch 家谱数据的中间件服务，旨在为开发者提供便捷的家谱数据访问能力。

核心功能

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

适用场景

• 家谱研究
• 历史数据分析
• 家族关系可视化
• 教育用途

工具列表

Basic

• say-hello: 简单的问候功能
• configure: 设置 FamilySearch API 凭证
• authenticate: 登录 FamilySearch
• get-current-user: 查看当前用户详情

Family Tree

• search-persons: 在家谱中搜索人物
• get-person: 获取特定人物的详细信息
• get-ancestors: 查看祖先（最多8代）
• get-descendants: 查看后代（最多3代）

Historical Records

• search-records: 搜索历史记录集合

常见问题解答

• 安全问题：凭证存储在本地 ~/.familysearch-mcp/config.json，切勿共享此文件。

使用教程

使用依赖

• Node.js 16+ 和 npm
• FamilySearch 开发者账号和 API 凭证
• 具有家谱数据访问权限的 FamilySearch 用户账号

安装教程

1. 克隆仓库
2. 安装依赖:

npm install

1. 构建项目:

npm run build

FamilySearch API 设置

1. 访问 FamilySearch Developers
2. 使用 FamilySearch 账号登录
3. 创建新应用
4. 设置重定向 URI 为 https://localhost:8080/oauth-redirect
5. 复制 Client ID 用于配置

调试方式

运行服务器:

npm start

配置 API 凭证:

Configure FamilySearch API credentials with clientId: YOUR_CLIENT_ID_HERE

认证:

Authenticate with FamilySearch using username: your_username and password: your_password

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。