MCP server with full coverage of the Gramps Web API REST endpoint functionality. Super-powers for your genealogy research with the help of AI.
接入配置
选择客户端,复制配置,再按项目文档补齐环境变量。
本地运行
claude mcp add gramps-mcp --env GRAMPS_MCP_USERNAME='<GRAMPS_MCP_USERNAME>' --env GRAMPS_MCP_PASSWORD='<GRAMPS_MCP_PASSWORD>' -- uvx gramps-mcp-full~/.codex/config.toml
[mcp_servers.gramps-mcp]
command = "uvx"
args = ["gramps-mcp-full"]
env = { GRAMPS_MCP_USERNAME = "<GRAMPS_MCP_USERNAME>", GRAMPS_MCP_PASSWORD = "<GRAMPS_MCP_PASSWORD>" }
# codex mcp add gramps-mcp --env GRAMPS_MCP_USERNAME='<GRAMPS_MCP_USERNAME>' --env GRAMPS_MCP_PASSWORD='<GRAMPS_MCP_PASSWORD>' -- uvx gramps-mcp-full~/.cursor/mcp.json
{
"mcpServers": {
"gramps-mcp": {
"command": "uvx",
"args": [
"gramps-mcp-full"
],
"env": {
"GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
"GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"gramps-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"gramps-mcp-full"
],
"env": {
"GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
"GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"gramps-mcp": {
"command": "uvx",
"args": [
"gramps-mcp-full"
],
"env": {
"GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
"GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"gramps-mcp": {
"command": "uvx",
"args": [
"gramps-mcp-full"
],
"env": {
"GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
"GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"gramps-mcp": {
"command": "uvx",
"args": [
"gramps-mcp-full"
],
"env": {
"GRAMPS_MCP_USERNAME": "<GRAMPS_MCP_USERNAME>",
"GRAMPS_MCP_PASSWORD": "<GRAMPS_MCP_PASSWORD>"
}
}
}
}远程托管
claude mcp add --transport http gramps-mcp https://ghcr.io/oliverhruby/gramps-mcp:latest~/.codex/config.toml
[mcp_servers.gramps-mcp]
url = "https://ghcr.io/oliverhruby/gramps-mcp:latest"
# codex mcp add gramps-mcp --url https://ghcr.io/oliverhruby/gramps-mcp:latest~/.cursor/mcp.json
{
"mcpServers": {
"gramps-mcp": {
"url": "https://ghcr.io/oliverhruby/gramps-mcp:latest"
}
}
}.vscode/mcp.json
{
"servers": {
"gramps-mcp": {
"type": "http",
"url": "https://ghcr.io/oliverhruby/gramps-mcp:latest"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"gramps-mcp": {
"httpUrl": "https://ghcr.io/oliverhruby/gramps-mcp:latest"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"gramps-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://ghcr.io/oliverhruby/gramps-mcp:latest"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"gramps-mcp": {
"url": "https://ghcr.io/oliverhruby/gramps-mcp:latest"
}
}
}需要的环境变量
GRAMPS_MCP_USERNAMEGRAMPS_MCP_PASSWORD
把占位值换成你自己的密钥;不要把密钥提交到代码仓库。