ancestry-mcp
by: reeeeemo
Ancestry MCP server made with Python that allows interactability with .ged (GEDCOM) files
📌Overview
Purpose: To provide a Python-based server for interacting with GEDCOM files, primarily targeting ancestry data from platforms like Ancestry.com.
Overview: The Ancestry MCP Server is built on the Model Context Protocol Python SDK, enabling seamless operations with .ged
files. It simplifies the management of genealogical data by offering file parsing and search functionalities.
Key Features:
-
Read and Parse .ged Files: Allows users to read and extract information from GEDCOM files, facilitating easy access to genealogical data.
-
Rename .ged Files: Provides functionality to rename GEDCOM files within a specified directory, helping maintain organized records.
-
Search Functionality: Enables users to search for specific individuals or families within .ged files, enhancing the usability and efficiency of data retrieval.
Ancestry MCP Server
Built on top of the Model Context Protocol Python SDK
Overview
Python server implementing Model Context Protocol (MCP) for interactibility with .ged
files (GEDCOM files, commonly seen on Ancestry.com).
Features
- Read and parse
.ged
files - Rename
.ged
files - Search within
.ged
files for individuals, family, etc.
Note: The server will only allow operations within the directory specified via args
.
Resources
gedcom://{file_name}
:.ged
operations interface
Tools
-
list_files
- List one or multiple
.ged
files within the directory - Input:
name
(string)
- List one or multiple
-
rename_file
- Rename one or multiple
.ged
files within the directory - Inputs:
file_name
(string): Old file namenew_name
(string)
- Rename one or multiple
-
view_file
- Parse and read full contents of a
.ged
file - Can also parse and read multiple files
- Retrieve specific information such as date of birth, marriage, etc.
- Input:
name
(string)
- Parse and read full contents of a
Usage with Claude Desktop
Installing via Smithery
To install Ancestry GEDCOM Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-server-ancestry --client claude
Installing Manually
- Install the package:
pip install mcp-server-ancestry
- Add this to your
claude_desktop_config.json
:
{
"mcpServers": {
"ancestry": {
"command": "mcp-server-ancestry",
"args": ["--gedcom-path", "path/to/your/gedcom/files"]
}
}
}
License
This project is licensed under the MIT License - see the LICENSE file for details.