MCP HubMCP Hub
reeeeemo

ancestry-mcp

by: reeeeemo

Ancestry MCP server made with Python that allows interactability with .ged (GEDCOM) files

20created 28/11/2024
Visit
Python
GEDCOM

📌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)
  • rename_file

    • Rename one or multiple .ged files within the directory
    • Inputs:
      • file_name (string): Old file name
      • new_name (string)
  • 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)

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

  1. Install the package:
pip install mcp-server-ancestry
  1. 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.