GEDCOM MCP Server

Genealogy for AI Agents, by AI Agents

A MCP server for creating, editing and querying genealogical data from GEDCOM files. Works great with qwen-cli and gemini-cli

Mostly written by various AI Agents, while some parenting was sometimes quite necessary...

It's more an experiment than some finish product and the list of tools is probably way to high but it's covering a lot of various tasks. Test files will be re-added after they are sorted...

It's able to search the genealogy about complex queries Also useful for automatically filling the GEDCOM file from internet info (for example, build a full family GEDCOM from a person wikipedia page..) and creating some nice biography for any GEDCOM individual, being able to complete the document with geographic or historal context by searching the web

Some sample complex prompts:

   Load gedcom "myfamily.ged"
   Make a complete, detailled biography of <name of some people from the GEDCOM> and his fammily. Use as much as you can from this genealogy, including any notes from him or his relatives. 
   You can try to find some info on Internet to complete the document, add some historical or geographic context, etc. Be as complete as possible to tell us a nice story, easy to read by everyone

  Create a new GEDCOM file - save it to "napo.ged"                                                                                                                                              
  Fetch the content of Napoleon I's Wikipedia page                                                                                                                                           
    1. Extract genealogical information about him and people mentioned on his page                                                                                                             
    2. Follow links to other people's Wikipedia pages to gather more information                                                                                                              
    3. Create a comprehensive genealogical record  with as much details as possible. Including birth/death dates and place, family relationships (parents, spouses, children...), occupation, etc, and including a note with the person wikipedia page address and important info about his life                                                                                                                    
    4. Repeat the same process with all people added by previous steps                                                                                                                       
   Continuously save the GEDCOM file as new people are added

   Load gedcom "myfamily.ged"
   What's shortest path from John Doe to Bob Smith ?
   And who are their common ancestors ?

Features

Load and parse GEDCOM files
Add/edit people, families, events, and places
Query people, families, events, and places
Find relationships between individuals
Generate family trees and timelines
Search across all genealogical data
Get detailed person and family information
Analyze genealogical data with statistics and duplicates detection

Installation

Clone the repository:
git clone https://github.com/airy10/GedcomMCP.git cd GedcomMCP
Install the required dependencies:
pip install -r requirements.txt

Usage

To start the server with the default HTTP transport:

python src/gedcom_mcp/fastmcp_server.py

To start the server with stdio transport:

python src/gedcom_mcp/fastmcp_server.py --transport stdio

To specify a different host or port for the HTTP transport:

python src/gedcom_mcp/fastmcp_server.py --host 0.0.0.0 --port 8080

Running Tests

To run all tests:

python -m pytest tests/

To run tests with verbose output:

python -m pytest tests/ -v

To run a specific test file:

python -m pytest tests/test_gedcom_data_access.py

To run a specific test:

python -m pytest tests/test_gedcom_data_access.py::TestGedcomDataAccess::test_load_gedcom_file

Project Structure

src/gedcom_mcp/: Main source code
- fastmcp_server.py: Main server application
- gedcom_*.py: Modules for handling GEDCOM data
tests/: Unit tests
to_be_sorted/: Files that need further organization
requirements.txt: Project dependencies
pyproject.toml: Build configuration

Contributing

Fork the repository
Create a new branch for your feature or bug fix
Make your changes and commit them with descriptive messages
Push your changes to your fork
Create a pull request to the main repository

License

This project is licensed under the MIT License.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI agents to create, edit, and query genealogical data from GEDCOM files. Supports complex genealogy searches, automatic data enrichment from web sources, relationship analysis, and biography generation for individuals and families.

Related MCP Servers

Ancestry MCP
reeeeemo
-
security
A
license
-
quality
Allows the AI to read .ged files and genetic data.
Last updated -
25
MIT License
Wegene Assistant MCP Server
xraywu
A
security
F
license
A
quality
Leverages large language models to analyze users' WeGene genetic testing reports, providing access to report data via custom URI schemes and enabling profile and report management through OAuth authentication and API utilization.
Last updated -
4
3
DICOM MCP Server
ChristianHinge
-
security
A
license
-
quality
Enables AI assistants to query and analyze medical imaging metadata from DICOM servers, including patient information, studies, series, and instances, as well as extract text from encapsulated PDF documents.
Last updated -
62
MIT License
gnomAD MCP Server
shukwong
A
security
F
license
A
quality
Enables AI assistants to query genetic variant data, gene constraints, and population genetics information from the gnomAD (Genome Aggregation Database) through its GraphQL API. Supports searching for genes and variants, retrieving constraint scores, analyzing population frequencies, and accessing genomic coverage data.
Last updated -
9
9

View all related MCP servers

GEDCOM MCP Server