AI导哈

GEDCOM家谱查询工具

一个用于通过AI助手查询本地GEDCOM家谱文件的服务器工具，支持加载、搜索和浏览家族树。

  • by Genealogy-MCP
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Genealogy-MCP/gedcom-mcp

使用说明

gedcom mcp

用于查询本地的MCP服务器 GEDCOM 通过AI助手创建家谱文件。加载任意 .ged 文件和搜索、浏览和遍历您的家谱，而无需离开您的人工智能工作流程。

部分 家谱MCP 组织。

注： GitHub是一个只读镜像。发展发生在 GitLab.

可用工具

工具 说明
load_file 将GEDCOM（.ged）文件加载并解析到内存中
search_persons 按姓名、日期、地点、性别搜索个人
get_person 通过交叉引用ID检索特定个人
get_family 检索族记录（接受族或个人外部参照）
get_ancestors 获取个人的祖先树
get_descendants 获取个人的后代树
get_stats 获取加载的GEDCOM文件的统计信息

配置

所有设置都是可选的，具有合理的默认值。

环境变量 默认值 描述
GEDCOM_MAX_FILE_SIZE_MB 100 允许的最大GEDCOM文件大小（MB）
GEDCOM_DEFAULT_ANCESTOR_DEPTH 5 默认祖先遍历深度
GEDCOM_DEFAULT_DESCENDANT_DEPTH 5 默认子体遍历深度
GEDCOM_MAX_TREE_DEPTH 50 穿越深度上的硬天花板
GEDCOM_MAX_SEARCH_RESULTS 100 返回的最大搜索结果数
GEDCOM_ALLOWED_BASE_DIRS （空） 逗号分隔的允许文件加载目录

设置：克劳德桌面

添加到您的 claude_desktop_config.json:

使用紫外线（局部）

{
  "mcpServers": {
    "gedcom": {
      "command": "uv",
      "args": ["--directory", "/path/to/gedcom-mcp", "run", "gedcom-mcp"],
      "env": {
        "GEDCOM_ALLOWED_BASE_DIRS": "/path/to/your/gedcom/files"
      }
    }
  }
}

使用Docker

{
  "mcpServers": {
    "gedcom": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/path/to/your/gedcom/files:/data:ro",
        "-e", "GEDCOM_ALLOWED_BASE_DIRS=/data",
        "ghcr.io/genealogy-mcp/gedcom-mcp"
      ]
    }
  }
}

设置：克劳德代码

使用紫外线（局部）

claude mcp add gedcom -- uv --directory /path/to/gedcom-mcp run gedcom-mcp

使用Docker

claude mcp add gedcom -- docker run -i --rm \
  -v /path/to/your/gedcom/files:/data:ro \
  -e GEDCOM_ALLOWED_BASE_DIRS=/data \
  ghcr.io/genealogy-mcp/gedcom-mcp

发展

# Install dependencies
make install

# Run tests with coverage
make test

# Run all checks (lint + type-check + test + audit)
make ci

# Format code
make format

# Run via stdio transport
make run-stdio

# Run via streamable-http on port 8000
make run

许可证

仅限AGPL-3.0

相关 MCP