Ancestry MCP

🚀 祖先 MCP 服务器

本项目是一个基于 Python 实现的 Model Context Protocol (MCP) 服务器，可与 .ged 文件（常见于 Ancestry.com 的 GEDCOM 文件）进行交互，具备读取、解析、重命名以及搜索文件内特定信息等功能。

[![MIT 许可证][mit-badge]][mit-url] [![Python 版本][python-badge]][python-url] [![PyPI 版本][pypi-badge]][pypi-url]

基于 Model Context Protocol Python SDK 构建

🚀 快速开始

通过 Smithery 安装

要通过 Smithery 自动安装祖先 GEDCOM 服务器，可使用以下命令：

npx -y @smithery/cli install mcp-server-ancestry --client claude

手动安装

1. 首先，安装该包：

pip install mcp-server-ancestry

2. 将以下内容添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
     "ancestry": {
       "command": "mcp-server-ancestry",
       "args": ["--gedcom-path", "path/to/your/gedcom/files"]
     }
  }
}

✨ 主要特性

• 读取和解析：能够读取和解析 .ged 文件。
• 重命名：支持重命名 .ged 文件。
• 信息搜索：可在 .ged 文件中搜索特定个人、家庭等信息。

⚠️ 重要提示

该服务器的操作仅限于通过 args 指定的目录内。

📚 详细文档

资源

• gedcom://{file_name}：GEDCOM 文件操作接口。

工具

• list_files

  • 功能：列出指定目录内的 (一个或多个) .ged 文件。
  • 输入：name（字符串）。

• rename_file

  • 功能：重命名指定目录内的 (一个或多个) .ged 文件。
  • 输入：
    • file_name（字符串）：旧文件名。
    • new_name（字符串）：新文件名。

• view_file

  • 功能：解析并读取指定 .ged 文件的完整内容。可以解析和读取多个文件，还能从文件中获取特定信息，例如出生日期、结婚日期等。
  • 输入：name（字符串）。

📄 许可证

本项目根据 MIT License 分发，详见 LICENSE 文件获取详细信息。