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 文件獲取詳細信息。