🚀 家族搜索 MCP 服务器
这是一个用于 FamilySearch API 的 Model Context Protocol (MCP) 服务器，它能让 Claude 或 Cursor 这类 AI 工具直接与 FamilySearch 的家族历史数据交互，为家族历史研究带来便利。
🚀 快速开始
本服务器允许 AI 工具与 FamilySearch 家族历史数据交互。使用前，需完成服务器安装与 FamilySearch API 设置，配置好凭证后即可运行服务器进行交互。
✨ 主要特性
- 使用 FamilySearch 凭证进行身份验证。
- 在 FamilySearch 家族树中搜索个人记录。
- 查看个人信息的详细信息。
- 探索一个人的祖先和后代。
- 搜索历史记录。
📦 安装指南
先决条件
- Node.js 16+ 和 npm。
- FamilySearch 开发者账户及 API 凭证。
- 具备访问家族树数据的 FamilySearch 用户账户。
安装步骤
- 克隆此仓库。
- 安装依赖：
npm install
- 构建项目：
npm run build
FamilySearch API 设置
在使用该工具之前，您需要注册 FamilySearch API 访问权限：
- 访问 FamilySearch 开发者。
- 使用您的 FamilySearch 账户登录。
- 创建新应用。
- 将重定向 URI 设置为
https://localhost:8080/oauth-redirect（之后可以修改）。 - 复制您的客户端 ID，您需要它进行配置。
💻 使用示例
基本使用
运行服务器：
npm start
之后，在支持 MCP 的 AI 工具（如 Claude 或 Cursor）中，您可以使用 FamilySearch 工具直接与家族历史数据交互。
配置
首次使用 MCP 时，您需要配置您的 FamilySearch API 凭证：
使用 clientId: YOUR_CLIENT_ID_HERE 配置 FamilySearch API 凭证
然后使用您的 FamilySearch 用户名和密码进行身份验证：
使用 username: 您的用户名 和 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" 的人员
获取 ID 为 ABCD-123 的人员信息
以 4 代的方式获取 ID 为 ABCD-123 的祖先
搜索姓氏为 "Johnson"、出生地为 "England"、死亡日期为 "1880-01-01" 的记录
📚 详细文档
安全提示
⚠️ 重要提示
您的 FamilySearch 凭证存储在本地机器上的
~/.familysearch-mcp/config.json文件中。请勿与他人分享此文件。
📄 许可证
ISC