mcp-server-ancestry


Namemcp-server-ancestry JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
SummaryA Model Context Protocol server providing functionality to GEDCOM files via LLM usage
upload_time2024-11-30 16:43:49
maintainerNone
docs_urlNone
authorRobert Oxley
requires_python>=3.10
licenseMIT
keywords automation llm mcp
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Ancestry MCP Server
[![MIT licensed][mit-badge]][mit-url]
[![Python Version][python-badge]][python-url]

[mit-badge]: https://img.shields.io/pypi/l/mcp.svg
[mit-url]: https://github.com/reeeeemo/ancestry-mcp/blob/main/LICENSE
[python-badge]: https://img.shields.io/pypi/pyversions/mcp.svg
[python-url]: https://www.python.org/downloads/

Built on top of the [Model Context Protocol Python SDK](https://modelcontextprotocol.io)

## Overview

Python server implementing Model Context Protocol (MCP) for interactibility with `.ged` files *(Ancestry files)*

## Features
    
- Read and parse .ged files
- Rename `.ged` files
- Search within .ged files for certain 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 a (or multiple) `.ged` file within the directory
    - Input: `name` (string)

- **rename_file**
    - Renames a (or multiple) `.ged` file within the directory
    - Inputs:
        - `file_name` (string): Old file name
        - `new_name` (string)
 
- **view_file**
    - Parses and reads full contents of a `.ged` file
    - Can also parse and read multiple files
    - Can get specific information out of file(s), such as date of birth, marriage, etc.
    - Input: `name` (string)


## Usage with Claude Desktop

1. First, install the package:
```pip install mcp-server-ancestry```


Add this to your `claude_desktop_config.json` 

```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.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "mcp-server-ancestry",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "Robert Oxley <robbie@oxley.ca>",
    "keywords": "automation, llm, mcp",
    "author": "Robert Oxley",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/d3/88/13b0fc6c9fc428f1ebfae2004ec1a03d13f48efa90d9cb69e6aa3f6b2b02/mcp_server_ancestry-0.1.1.tar.gz",
    "platform": null,
    "description": "# Ancestry MCP Server\n[![MIT licensed][mit-badge]][mit-url]\n[![Python Version][python-badge]][python-url]\n\n[mit-badge]: https://img.shields.io/pypi/l/mcp.svg\n[mit-url]: https://github.com/reeeeemo/ancestry-mcp/blob/main/LICENSE\n[python-badge]: https://img.shields.io/pypi/pyversions/mcp.svg\n[python-url]: https://www.python.org/downloads/\n\nBuilt on top of the [Model Context Protocol Python SDK](https://modelcontextprotocol.io)\n\n## Overview\n\nPython server implementing Model Context Protocol (MCP) for interactibility with `.ged` files *(Ancestry files)*\n\n## Features\n    \n- Read and parse .ged files\n- Rename `.ged` files\n- Search within .ged files for certain individuals, family, etc\n\n**Note:** The server will only allow operations within the directory specified via `args`\n\n## Resources\n\n- `gedcom://{file_name}`: `.ged` operations interface\n\n## Tools\n\n- **list_files**\n    - List a (or multiple) `.ged` file within the directory\n    - Input: `name` (string)\n\n- **rename_file**\n    - Renames a (or multiple) `.ged` file within the directory\n    - Inputs:\n        - `file_name` (string): Old file name\n        - `new_name` (string)\n \n- **view_file**\n    - Parses and reads full contents of a `.ged` file\n    - Can also parse and read multiple files\n    - Can get specific information out of file(s), such as date of birth, marriage, etc.\n    - Input: `name` (string)\n\n\n## Usage with Claude Desktop\n\n1. First, install the package:\n```pip install mcp-server-ancestry```\n\n\nAdd this to your `claude_desktop_config.json` \n\n```json\n{\n  \"mcpServers\": {\n     \"ancestry\": {\n       \"command\": \"mcp-server-ancestry\",\n       \"args\": [\"--gedcom-path\", \"path/to/your/gedcom/files\"]\n     }\n  }\n}\n```\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A Model Context Protocol server providing functionality to GEDCOM files via LLM usage",
    "version": "0.1.1",
    "project_urls": null,
    "split_keywords": [
        "automation",
        " llm",
        " mcp"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ccb3b085717b77c9f5ae16963bf5e5ca261bf9bb63054d49b118022ae7cea946",
                "md5": "43c928e91230aadb06de547b21b01e29",
                "sha256": "a5b718bacc954cb71ad62d8d941c4f455021d06d3e6de60ec2fd753a16f9f1c1"
            },
            "downloads": -1,
            "filename": "mcp_server_ancestry-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "43c928e91230aadb06de547b21b01e29",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 6280,
            "upload_time": "2024-11-30T16:43:32",
            "upload_time_iso_8601": "2024-11-30T16:43:32.315759Z",
            "url": "https://files.pythonhosted.org/packages/cc/b3/b085717b77c9f5ae16963bf5e5ca261bf9bb63054d49b118022ae7cea946/mcp_server_ancestry-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d38813b0fc6c9fc428f1ebfae2004ec1a03d13f48efa90d9cb69e6aa3f6b2b02",
                "md5": "ce9517531fd155ff0da4378b82a3d68f",
                "sha256": "65f021989681ce48742a0258c556473efac92713e2e1b02005cc01d42728ea54"
            },
            "downloads": -1,
            "filename": "mcp_server_ancestry-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "ce9517531fd155ff0da4378b82a3d68f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 23510,
            "upload_time": "2024-11-30T16:43:49",
            "upload_time_iso_8601": "2024-11-30T16:43:49.195648Z",
            "url": "https://files.pythonhosted.org/packages/d3/88/13b0fc6c9fc428f1ebfae2004ec1a03d13f48efa90d9cb69e6aa3f6b2b02/mcp_server_ancestry-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-30 16:43:49",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "mcp-server-ancestry"
}
        
Elapsed time: 1.72908s