Ancestry GEDCOM Server 使用说明

项目简介

Ancestry GEDCOM Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它允许大型语言模型（LLM）与 GEDCOM (Genealogical Data Communication) 族谱文件进行交互。通过此服务器，LLM 可以读取、搜索、重命名 GEDCOM 文件，从而实现对族谱数据的智能访问和管理。

主要功能点

GEDCOM 文件访问: 支持读取和解析 '.ged' 格式的 GEDCOM 文件。
文件列表: 可以列出指定目录下的所有 GEDCOM 文件。
文件重命名: 允许重命名 GEDCOM 文件。
文件内容查看: 能够解析并查看 GEDCOM 文件的详细内容，包括个人信息、家庭关系等。
搜索功能: 支持在 GEDCOM 文件中搜索特定个人或家庭信息（当前版本的功能描述中Search within files for certain individuals, family, etc.，但工具中未体现，实际功能以工具为准，此处以工具功能为准）。

安装步骤

安装 Python 包: 打开终端或命令提示符，运行以下命令安装 'mcp-server-ancestry' Python 包：
```
pip install mcp-server-ancestry
```

服务器配置

要将 Ancestry GEDCOM Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 MCP 服务器设置。以下是一个 'claude_desktop_config.json' 文件的配置示例：

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

配置参数说明:

'server name': 'ancestry' (服务器名称，可以自定义，客户端通过此名称与服务器交互)
'command': 'mcp-server-ancestry' (启动 Ancestry GEDCOM Server 的命令)
'args': 启动命令的参数列表，用于配置服务器行为。
- '--gedcom-path': 必需参数。指定包含 GEDCOM 文件的目录的路径。请将 '/path/to/your/gedcom/files' 替换为您实际存放 GEDCOM 文件的目录路径。

注意: 请确保指定的 GEDCOM 文件目录存在，并且服务器进程对该目录具有读取权限。

基本使用方法

启动 MCP 客户端: 启动配置了 Ancestry GEDCOM Server 的 MCP 客户端（例如 Claude Desktop）。
连接服务器: 客户端会根据配置文件自动尝试连接到 Ancestry GEDCOM Server。
使用工具: 在 LLM 交互界面中，您可以指示 LLM 使用以下工具来操作 GEDCOM 文件：
- 'list_files': 列出 GEDCOM 文件。输入参数 'name' (string, 可选的文件名，不指定则列出所有文件)。
- 'rename_file': 重命名 GEDCOM 文件。输入参数 'file_name' (string, 旧文件名) 和 'new_name' (string, 新文件名)。
- 'view_file': 查看 GEDCOM 文件内容。输入参数 'name' (string, 文件名)。
例如，您可以指示 Claude 这样的客户端执行类似 “列出所有 GEDCOM 文件” 或 “查看文件名为 example.ged 的族谱文件内容” 的操作。LLM 将会调用相应的工具并返回结果。

关键词