使用说明
维基树mcp
MCP服务器暴露 维基树 谱系API通过代码模式架构。仅限公共配置文件，无需身份验证。
注： GitHub是一个只读镜像。发展发生在 GitLab.
建筑
此服务器使用2个元工具(search + execute)服务器端注册表中有10个操作。LLM通过以下方式发现操作 search 并通过以下方式运行它们 execute.
| 工具 | 说明 |
|---|---|
search |
发现可用的操作及其参数 |
execute |
对WikiTree API运行命名操作 |
运营
| 操作 | 类别 | 描述 |
|---|---|---|
get_profile |
read | 检索人员或可用空间配置文件 |
get_person |
read | 检索个人资料（仅限个人资料） |
get_people |
read | 按键或关系获取多个配置文件 |
search_person |
搜索 | 按姓名、日期、地点、性别搜索个人资料 |
get_ancestors |
分析 | 获取祖先树（父母、祖父母等） |
get_descendants |
分析 | 获取后代树（子、孙等） |
get_relatives |
阅读 | 找到父母、孩子、兄弟姐妹、配偶 |
get_bio |
内容 | 检索传记文本 |
get_photos |
内容 | 获取链接到个人资料的照片 |
get_categories |
content | 检索关联的类别 |
配置
| 环境变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
WIKITREE_APP_ID |
没有 | Genealogy-MCP_wikitree-mcp |
您的WikiTree API应用程序标识符 |
WIKITREE_API_BASE_URL |
没有 | https://api.wikitree.com/api.php |
WikiTree API端点 |
WIKITREE_HTTP_TIMEOUT |
没有 | 10.0 |
HTTP请求超时（秒） |
WIKITREE_MAX_RETRIES |
没有 | 3 |
瞬时故障的最大重试次数 |
设置：克劳德桌面
添加到您的 claude_desktop_config.json:
使用紫外线（局部）
{
"mcpServers": {
"wikitree": {
"command": "uv",
"args": ["--directory", "/path/to/wikitree-mcp", "run", "wikitree-mcp"],
"env": {
"WIKITREE_APP_ID": "your-app-id"
}
}
}
}
使用Docker
{
"mcpServers": {
"wikitree": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "WIKITREE_APP_ID=your-app-id", "wikitree-mcp"]
}
}
}
设置：克劳德代码
使用紫外线（局部）
claude mcp add wikitree -- uv --directory /path/to/wikitree-mcp run wikitree-mcp
设置环境变量：
export WIKITREE_APP_ID=your-app-id
使用Docker
claude mcp add wikitree -- docker run -i --rm -e WIKITREE_APP_ID=your-app-id wikitree-mcp
发展
make install # Install dependencies
make test # Run tests with coverage (mocked, no network)
make test-live # Run live tests against real WikiTree API
make ci # Full CI pipeline (lint + typecheck + test + audit)
make format # Auto-format code
make build # Build wheel
make run # Run with streamable-http on port 8000
make run-stdio # Run with stdio transport
许可证
仅限AGPL-3.0
