Gramps Web MCP — MCP-сервер для Claude Code
Подключает языковые модели к генеалогической базе Gramps Web через MCP. Позволяет исследовать семейные связи и дополнять записи архивными источниками прямо в чате.
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GRAMPS_API_URL=<GRAMPS_API_URL> --env GRAMPS_USERNAME=<GRAMPS_USERNAME> --env GRAMPS_PASSWORD=<GRAMPS_PASSWORD> --env GRAMPS_REFRESH_TOKEN=<GRAMPS_REFRESH_TOKEN> --transport stdio gramps-web-mcp -- docker run -i --rm -e MCP_TRANSPORT -e GRAMPS_API_URL -e GRAMPS_USERNAME -e GRAMPS_PASSWORD -e GRAMPS_REFRESH_TOKEN ghcr.io/scormave/gramps-web-mcp:2.6.0Что делает Gramps Web MCP
Сервер работает в связке с запущенным инстансом Gramps Web, не заменяя его веб-интерфейс. Агенту передаётся набор из 32 инструментов. Среди них — текстовый поиск, фильтрация через Gramps QL, редактирование персон и событий, а также расчёт линий предков и потомков.
Предусмотрены откат отдельных правок и режим только для чтения. При передаче превью картинок сервер очищает метаданные EXIF и GPS. Опасные операции delete_object и undo_change запрашивают подтверждение у человека, если используемый клиент поддерживает элиситацию.
Для работы обязательно нужны поднятый экземпляр Gramps Web с доступом к API и настроенная авторизация. Без готового сервера генеалогии контейнеру не к чему обращаться.
Какие задачи решает
- построить линии предков или потомков для выбранной персоны
- добавить факт события с привязкой архивных источников и цитат
- найти людей без установленных родственных связей
- откатить ошибочную транзакцию без потери более поздних правок
Примеры запросов агенту
- Построй список прямых предков для персоны с идентификатором
I0001. - Добавь факт рождения в запись
I0042и привяжи архивный источник. - Найди в базе Gramps Web всех людей с фамилией Иванов.
Как установить Gramps Web MCP
Командой платформы
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GRAMPS_API_URL=<GRAMPS_API_URL> --env GRAMPS_USERNAME=<GRAMPS_USERNAME> --env GRAMPS_PASSWORD=<GRAMPS_PASSWORD> --env GRAMPS_REFRESH_TOKEN=<GRAMPS_REFRESH_TOKEN> --transport stdio gramps-web-mcp -- docker run -i --rm -e MCP_TRANSPORT -e GRAMPS_API_URL -e GRAMPS_USERNAME -e GRAMPS_PASSWORD -e GRAMPS_REFRESH_TOKEN ghcr.io/scormave/gramps-web-mcp:2.6.0Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Командой платформы
codex mcp add gramps-web-mcp --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GRAMPS_API_URL=<GRAMPS_API_URL> --env GRAMPS_USERNAME=<GRAMPS_USERNAME> --env GRAMPS_PASSWORD=<GRAMPS_PASSWORD> --env GRAMPS_REFRESH_TOKEN=<GRAMPS_REFRESH_TOKEN> -- docker run -i --rm -e MCP_TRANSPORT -e GRAMPS_API_URL -e GRAMPS_USERNAME -e GRAMPS_PASSWORD -e GRAMPS_REFRESH_TOKEN ghcr.io/scormave/gramps-web-mcp:2.6.0Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"gramps-web-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"GRAMPS_API_URL",
"-e",
"GRAMPS_USERNAME",
"-e",
"GRAMPS_PASSWORD",
"-e",
"GRAMPS_REFRESH_TOKEN",
"ghcr.io/scormave/gramps-web-mcp:2.6.0"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"GRAMPS_API_URL": "<GRAMPS_API_URL>",
"GRAMPS_USERNAME": "<GRAMPS_USERNAME>",
"GRAMPS_PASSWORD": "<GRAMPS_PASSWORD>",
"GRAMPS_REFRESH_TOKEN": "<GRAMPS_REFRESH_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"gramps-web-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"GRAMPS_API_URL",
"-e",
"GRAMPS_USERNAME",
"-e",
"GRAMPS_PASSWORD",
"-e",
"GRAMPS_REFRESH_TOKEN",
"ghcr.io/scormave/gramps-web-mcp:2.6.0"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"GRAMPS_API_URL": "<GRAMPS_API_URL>",
"GRAMPS_USERNAME": "<GRAMPS_USERNAME>",
"GRAMPS_PASSWORD": "<GRAMPS_PASSWORD>",
"GRAMPS_REFRESH_TOKEN": "<GRAMPS_REFRESH_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e MCP_TRANSPORT=<MCP_TRANSPORT> -e GRAMPS_API_URL=<GRAMPS_API_URL> -e GRAMPS_USERNAME=<GRAMPS_USERNAME> -e GRAMPS_PASSWORD=<GRAMPS_PASSWORD> -e GRAMPS_REFRESH_TOKEN=<GRAMPS_REFRESH_TOKEN> gramps-web-mcp docker run -i --rm -e MCP_TRANSPORT -e GRAMPS_API_URL -e GRAMPS_USERNAME -e GRAMPS_PASSWORD -e GRAMPS_REFRESH_TOKEN ghcr.io/scormave/gramps-web-mcp:2.6.0Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Gramps Web MCP
Как установить Gramps Web MCP в Claude Code?
Выполните команду добавления через Docker: `claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env GRAMPS_API_URL=<GRAMPS_API_URL> --env GRAMPS_USERNAME=<GRAMPS_USERNAME> --env GRAMPS_PASSWORD=<GRAMPS_PASSWORD> --env GRAMPS_REFRESH_TOKEN=<GRAMPS_REFRESH_TOKEN> --transport stdio gramps-web-mcp -- docker run -i --rm -e MCP_TRANSPORT -e GRAMPS_API_URL -e GRAMPS_USERNAME -e GRAMPS_PASSWORD -e GRAMPS_REFRESH_TOKEN ghcr.io/scormave/gramps-web-mcp:2.6.0`.
Что делает Gramps Web MCP?
Сервер даёт ИИ-клиентам структурированный доступ к дереву Gramps Web: позволяет выполнять поиск, строить цепочки родства, изменять записи и запрашивать метаданные древа через протокол MCP.
Можно ли включить режим только для чтения?
Да, для этого контейнеру передают переменную окружения -e GRAMPS_READ_ONLY=true. Сервер отключит инструменты модификации и заблокирует любые прямые правки в базе.
