genealogy-mcp

genealogy-mcp — encuentra tu historia familiar con cualquier asistente de IA

Versión en ruso

Un servidor MCP que convierte a Claude, ChatGPT, Cursor o cualquier asistente compatible con MCP en un genealogista cuidadoso. Sabe dónde están los registros de tus antepasados (114 archivos y bases de datos en Rusia y la antigua URSS, Europa, las Islas Británicas, EE. UU. y América Latina), cómo buscarlos (variantes de nombre, transliteraciones, ortografía antigua, calendario juliano) y cuándo un hallazgo realmente es tu persona — para que el asistente te dé enlaces funcionales y un plan en lugar de suposiciones confiadas.

Construido a partir de años de investigación real para un archivo familiar abierto (igoruan.ru/gene, motor: gene_archive): registros parroquiales, listas de revisión, bases de datos de la Primera y Segunda Guerra Mundial, expedientes de represión, registros de emigración — y cada trampa en la que caímos en el camino.

Lo que puedes preguntar

Mi bisabuelo Ivan Kolodin nació alrededor de 1885 cerca de Bogoroditsk, provincia de Tula. ¿Dónde busco?

El asistente hace un plan para Rusia 1880–1945, lee las guías de registros, construye las formas del nombre (Колодин / Колодина / Колодинъ / Kolodin / Kołodin…), te da enlaces de búsqueda para FamilySearch, el texto completo de Internet Archive y las bases de datos de guerra rusas, te dice qué archivo tiene los registros parroquiales y redacta la solicitud.

¿Es este registro de bautismo el mismo Iván? Dice «Іоаннъ, padre Петръ, 1887, Сынково».

check_match compara hecho por hecho con variantes de nombre y tolerancia de edad: dos hechos independientes más allá del nombre → confirmado; uno → probable; una contradicción → busca un tercer documento.

¿Qué es para mí la hija de la prima de mi abuela? ¿Y cómo se dice en ruso?

kinship → «троюродная сестра… / first cousin once removed» — en ruso, inglés y rumano, con la proporción esperada de ADN.

Revisa mi árbol. (un GEDCOM de Ancestry, MyHeritage, Gramps, Geni…)

audit_tree encuentra lo imposible (nacido después de la muerte de la madre, una madre de 10 años, muerte antes del nacimiento), posibles duplicados y vacíos — una lista de tareas para la próxima búsqueda.

El registro dice que nació «на Покров» 1885, el año está escrito ҂аѡ҃пе.

cyrillic_numerals lee el año (1885), feast_date da el 1 de octubre (juliano) = 13 de octubre de 1885.

Compartimos 230 cM con una coincidencia en MyHeritage. ¿Quién podría ser?

dna_match: prima segunda, prima primera dos veces removida, media prima primera… — y por qué solo los documentos pueden decidir.

¿Dónde están ahora los registros parroquiales de la gobernación de Volinia?

where_are_records: los archivos estatales de Zhytomyr (el consistorio), Rivne y Volyn — las fronteras se movieron, así que no siempre es el archivo de la región actual.

Recuerda lo que encontramos y continúa la próxima semana.

Un proyecto de investigación en tu computadora: personas, fuentes con citas completas, pistas abiertas y un registro de cada búsqueda — incluyendo "nada encontrado" — para que nadie busque el mismo lugar dos veces. GEDCOM de entrada y salida.

Escribe lo que encontramos en nuestro sitio familiar.

Si tu archivo familiar es un sitio gene-archive, dale a las herramientas del proyecto la ruta de su carpeta: el asistente lee el archivo mismo — quién falta, qué fechas no tienen documento — y cada cambio que hace pasa por las propias verificaciones del sitio, aterriza en sus correcciones y registros de investigación, se confirma en git bajo tu nombre y reconstruye el sitio. Muestra el cambio primero y escribe solo después de tu sí.

Por qué usarlo

Sin él	Con genealogy-mcp
El asistente nombra dos o tres sitios web famosos	114 fuentes elegidas por país, años y tipo de registro, cada una con "cómo buscarla bien"
Busca una sola ortografía	Variantes ortográficas, ortografía anterior a 1918, formas masculinas/femeninas, 9 sistemas de transliteración, equivalentes de nombres de pila (Иван = Іоаннъ = Jan = Johann = Juan)
URLs inventadas o rotas	Enlaces de búsqueda listos construidos a partir de plantillas de URL probadas; un trabajo semanal verifica cada sitio
"Este es probablemente tu antepasado"	Una regla de evidencia explícita: un homónimo no es un pariente
Fechas tomadas al pie de la letra	Juliano ↔ Gregoriano, años de nacimiento a partir de edades con deriva realista, fechas normalizadas a GEDCOM
Consejos genéricos	Guías de registros: registros parroquiales, listas de confesión, listas de revisión, libros de hogar, Primera/Segunda Guerra Mundial, expedientes de represión, listas de pasajeros, censos, registro civil europeo, registros latinoamericanos
Escribes a los archivos desde cero	Borradores de solicitudes para ZAGS ruso, archivos estatales, militares y del FSB, y para cualquier archivo en inglés, español o portugués
Olvida todo entre chats	Un proyecto de investigación que recuerda personas, fuentes, pistas y cada búsqueda
No puede leer números y fechas antiguos	Numerales en eslavo eclesiástico, fiestas religiosas, calendarios juliano, hebreo y republicano francés
"Busca tu nombre en FamilySearch"	Búsqueda en vivo en el texto completo de Internet Archive, WikiTree, Open Archives e historia de lugares de Wikidata
Las coincidencias de ADN son un misterio	cM compartidos → las relaciones que encajan

Todo se ejecuta en tu computadora. El servidor se conecta en línea solo cuando el asistente ejecuta una búsqueda en vivo (search_online, place_history), y luego envía esa consulta a ese único sitio.

Cobertura

• Mundial: FamilySearch (registros y el catálogo de imágenes no indexadas), texto completo de Internet Archive, MyHeritage, Geni, WikiTree, Find a Grave, BillionGraves, Archivos Arolsen, Yad Vashem, JewishGen, Matricula, Geneanet, Wikipedia.
• Rusia y la URSS: Archivo Yandex, guías de archivo, foro VGD, Pamyat Naroda, OBD Memorial, gwar.mil.ru, Open List, Immortal Barrack, Returned Names, mártires de PSTGU, Bibliotecas Electrónicas Presidencial y Nacional, bibliotecas históricas, mapas antiguos, historia de la iglesia, RIA-1914, archivos regionales, ZAGS, TsAMO, RGVIA, RGIA, GARF.
• Ucrania, Bielorrusia, Moldavia, Rumania, Polonia, los Bálticos: portales y catálogos de archivos nacionales, TsDIAK, Geneteka, Szukajwarchiwach, epaveldas, Raduraksti, los archivos estonios.
• Europa: prisioneros de la Primera Guerra Mundial del CICR, CWGC, Volksbund, ScotlandsPeople, FreeBMD, registros civiles y censos irlandeses, Archion, GenWiki, FranceArchives, Mémoire des hommes, Antenati, PARES, Digitarq, Open Archives (NL), Archivos Estatales Belgas, Riksarkivet, Digitalarkivet, Danish Family Search, HisKi, Archivo Digital Finlandés, Hungaricana, Acta Publica (Chequia), archivos estatales búlgaros, FreeCEN, FreeREG, The National Archives, GRO, Welsh Newspapers.
• Alemania y tierras de habla alemana: listas de bajas de la Primera Guerra Mundial, GEDBAS, Online-OFB, Biblioteca Digital Alemana, Bundesarchiv, Léxico Biográfico Báltico, alemanes del Mar Negro (Odessa3), Proyecto Poznań, Metryki.
• Genealogía judía: JRI-Poland, Gesher Galicia, LitvakSIG, JewishGen, Yad Vashem, herramientas One-Step de Steve Morse.
• Cáucaso y Asia Central: Archivos Nacionales de Georgia, archivos estatales centrales de Kazajistán, Uzbekistán, Kirguistán, Tayikistán y Turkmenistán.
• Las Américas: FamilySearch América Latina, AGN México, Arquivo Nacional y Museu da Imigração (Brasil), Hemeroteca Digital, CEMLA y AGN (Argentina), Archivo Nacional (Chile), NARA, Ellis Island, Chronicling America, USGenWeb, Library and Archives Canada, BAnQ (Quebec), Pier 21.
• Australia y Nueva Zelanda: Trove, Archivos Nacionales de Australia, Papers Past, BDM de Nueva Zelanda.

Guías de registros en inglés, ruso y ucraniano; las principales también en español, portugués, polaco y alemán.

Instalación

Claude Desktop, un clic: descarga genealogy-mcp-<version>.mcpb de la última versión y ábrelo — Claude Desktop lo instala y pregunta dónde guardar tus proyectos de investigación.

Para las otras formas necesitas uv (obtiene Python y el paquete por sí mismo).

Claude Desktop, a mano — Configuración → Desarrollador → Editar configuración, añade:

{
  "mcpServers": {
    "genealogy": {
      "command": "uvx",
      "args": ["genealogy-mcp"]
    }
  }
}

Claude Code:

claude mcp add genealogy -- uvx genealogy-mcp

Cursor (~/.cursor/mcp.json), Windsurf, Cline — el mismo bloque mcpServers que para Claude Desktop. VS Code (.vscode/mcp.json): {"servers": {"genealogy": {"command": "uvx", "args": [ …same… ]}}}.

Docker: docker build -t genealogy-mcp . y luego docker run -i --rm genealogy-mcp (stdio) o docker run --rm -p 8000:8000 genealogy-mcp --http --host 0.0.0.0 (HTTP en /mcp).

Tu sitio gene-archive como proyecto: instala el servidor junto con gene-archive — pip install "genealogy-mcp[site]" o uvx --from "genealogy-mcp[site]" genealogy-mcp (el comando gene se encuentra en PATH o junto al Python del servidor; en otros lugares establece GENE_CMD), luego nombra la carpeta en GENEALOGY_MCP_SITES (o en la configuración de la extensión de Claude Desktop), o simplemente da su ruta al asistente. GENE_AUTHOR establece el nombre en el historial de git (predeterminado: git config user.name).

Clientes que se conectan por HTTP (conectores de ChatGPT, agentes remotos): ejecuta genealogy-mcp --http --host 0.0.0.0 --port 8000 detrás de HTTPS y añade https://your-host/mcp. En modo HTTP, audit_tree toma solo el texto GEDCOM, nunca una ruta de archivo.

El paquete está en PyPI y en el Registro MCP oficial (io.github.igormel81/genealogy-mcp): uvx genealogy-mcp lo instala y lo ejecuta.

Herramientas

Herramienta	Qué hace
plan_research	Un plan paso a paso para un país y período: qué registros existen, guías, fuentes en orden
find_sources	Fuentes por país/región (europe, latin_america, russian_empire…), años y tipo de registro
source_details	Una fuente: cobertura, acceso, cómo buscar
where_are_records	Qué archivos tienen ahora los registros de una provincia histórica (Imperio Ruso, Polonia, Galicia, Bucovina, Prusia Oriental, los Bálticos, el Cáucaso)
search_links	URLs de búsqueda listas para un nombre y sus variantes
search_online	Búsqueda en vivo: texto completo de Internet Archive, Chronicling America, WikiTree, Open Archives, Open List
place_history	Wikidata: a qué perteneció un pueblo a lo largo de los años, coordenadas, artículo de Wikipedia
name_variants	Ortografía, ortografía antigua, formas con género, transliteraciones, códigos Daitch–Mokotoff, equivalentes de nombres de pila (incl. yiddish y hebreo), patronímicos
normalize_date	"около 1899", "9 de octubre de 1899" → ABT 1899, 9 OCT 1899
convert_calendar	Juliano ↔ Gregoriano, hebreo, republicano francés
feast_date	«на Покров», «после Петрова поста», Pascua, Wielkanoc… → la fecha en un año dado
cyrillic_numerals	҂аѡ҃п ↔ 1880
birth_year_from_age	El rango de año de nacimiento a partir de una edad en un registro
kinship	El nombre de un parentesco en ru/en/ro, con la proporción esperada de ADN
dna_match	cM compartidos → las relaciones que encajan (Shared cM Project 4.0)
check_match	¿Es un registro encontrado nuestra persona? Un veredicto con cada hecho comparado (también apellidos dobles hispanos)
audit_tree	Hechos imposibles, duplicados y vacíos en un GEDCOM o family_tree.json
project_view, project_save, project_log, project_transfer	El proyecto de investigación entre conversaciones: personas, familias, fuentes, pistas, el registro de búsqueda, importación/exportación GEDCOM — o una carpeta de sitio gene-archive, escrita a través de sus verificaciones y registros
draft_archive_request	Una carta de solicitud a una oficina de registro o archivo
record_guide	Cómo leer y encontrar un tipo de registro
glossary	Términos de registros rusos antiguos explicados

Recursos: genealogy://sources (el catálogo), genealogy://guide/research/{en|ru} (una guía de investigación completa), genealogy://guide/prompts/{en|ru} (solicitudes listas para cada paso), genealogy://records/{topic}, genealogy://glossary. Indicaciones: iniciar investigación, verificar un hallazgo, transcribir un registro, escribir a un archivo.

Privacidad y honestidad

• El servidor no envía nada a ningún lugar por sí mismo. Una búsqueda en vivo (search_online, place_history) envía la consulta — nombres, años, lugar — al único sitio buscado. Los proyectos de investigación son archivos en tu computadora (~/Documents/genealogy-mcp o GENEALOGY_MCP_HOME); en un servidor HTTP compartido están desactivados.
• El asistente que usas es un servicio separado con su propia política de privacidad — piensa antes de pegar detalles sobre personas vivas.
• Las cartas son borradores: tú las revisas y las envías.
• Las reglas que recibe el asistente: cita el original, conserva las versiones conflictivas, marca las conjeturas como "probablemente", nunca vincules a un homónimo sin evidencia.

Benchmark

evals/tasks.json contiene 32 preguntas con respuestas verificables: fechas por fiestas religiosas, calendarios juliano, hebreo y republicano, numerales cirílicos, Daitch–Mokotoff, ADN, parentesco, términos antiguos, archivos de provincias históricas, verificaciones de evidencia, historial de registros. evals/check_tools.py se ejecuta en CI y verifica que las herramientas respondan correctamente a todas ellas. evals/run.py hace las mismas preguntas a un modelo Claude sin el servidor y con él, y puntúa ambos (necesita una clave API; cuesta dinero, por lo que se ejecuta manualmente: Actions → Benchmark).

Contribuciones

Consulta CONTRIBUTING.md para los campos de fuentes y las pautas de contribución. ¿Falta una fuente o un enlace se movió? Edita tools/make_sources.py, ejecuta python3 tools/make_sources.py y python3 -m unittest discover tests, abre una solicitud de extracción. Las guías de registros viven en src/genealogy_mcp/guides.py.

Ver también

• gene_archive — un motor de código abierto para un sitio web de archivo familiar: árbol, historias, documentos, mapa, GEDCOM, un editor en línea y comentarios de familiares.

Licencia MIT.