Servidor MCP de FamilySearch

Este es un servidor de Protocolo de Contexto de Modelo (MCP) para las API de FamilySearch. Permite que herramientas de IA como Claude o Cursor interactúen directamente con los datos de historia familiar de FamilySearch.

Características

Autenticación con credenciales de FamilySearch
Buscar registros de personas en el Árbol Familiar de FamilySearch
Ver información detallada de la persona
Explorar antepasados y descendientes
Buscar registros históricos

Prerrequisitos

Node.js 16+ y npm
Una cuenta de desarrollador de FamilySearch y credenciales de API
Una cuenta de usuario de FamilySearch con acceso a los datos del Árbol Familiar

Instalación

Clonar este repositorio
Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Configuración de la API de FamilySearch

Antes de utilizar esta herramienta, deberá registrarse para obtener acceso a la API de FamilySearch:

Ir a Desarrolladores de FamilySearch
Inicie sesión con su cuenta de FamilySearch
Crear una nueva aplicación
Establezca la URI de redireccionamiento en https://localhost:8080/oauth-redirect (puede cambiarla más tarde)
Copia tu ID de cliente: lo necesitarás para la configuración

Uso

Ejecutar el servidor:

npm start

Luego, en su herramienta de inteligencia artificial compatible con MCP (como Claude o Cursor), puede usar las herramientas de FamilySearch para interactuar con los datos de historia familiar.

Configuración

La primera vez que utilice el MCP, deberá configurarlo con sus credenciales de API de FamilySearch:

Configure FamilySearch API credentials with clientId: YOUR_CLIENT_ID_HERE

Luego, autentíquese con su nombre de usuario y contraseña de FamilySearch:

Authenticate with FamilySearch using username: your_username and password: your_password

Una vez autenticado, sus credenciales se almacenarán de forma segura en ~/.familysearch-mcp/config.json para uso futuro.

Herramientas MCP disponibles

Básico

say-hello : una función de saludo sencilla
configure : configura tus credenciales de API de FamilySearch
authenticate : Iniciar sesión en FamilySearch
get-current-user : Ver detalles sobre su cuenta de FamilySearch

Árbol genealógico

search-persons : Busque personas en el árbol genealógico de FamilySearch
get-person : Ver información detallada sobre una persona específica
get-ancestors : Ver los antepasados de una persona (hasta 8 generaciones)
get-descendants : Ver los descendientes de una persona (hasta 3 generaciones)

Registros históricos

search-records : Busque en las colecciones de registros históricos de FamilySearch

Consultas de ejemplo

Search for persons with name: "John Smith" birthPlace: "New York"

Get person with personId: ABCD-123

Get ancestors for personId: ABCD-123 with generations: 4

Search records with surname: "Johnson" birthPlace: "England" deathDate: "1880-01-01"

Aviso de seguridad

Sus credenciales de FamilySearch se almacenan localmente en su equipo en ~/.familysearch-mcp/config.json . Nunca comparta este archivo con otros.

Licencia

ISC