Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Description from the maker (original English)
MCP server for structured access to Gramps Web genealogy data
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
MCP_TRANSPORT, GRAMPS_API_URL, GRAMPS_USERNAME, GRAMPS_PASSWORD, GRAMPS_REFRESH_TOKEN, GRAMPS_TREE_ID, GRAMPS_READ_ONLY, GRAMPS_MUTATION_SERIALIZE, GRAMPS_MUTATION_MIN_INTERVAL_MS, GRAMPS_CONFIRMATION, GRAMPS_LOG_LEVEL, GRAMPS_MEDIA_RESOURCES_ENABLED, GRAMPS_MEDIA_MAX_BYTES, GRAMPS_MEDIA_ALLOW_PRIVATE, GRAMPS_MEDIA_UPLOAD_DIRS, GRAMPS_MEDIA_UPLOAD_MAX_BYTESValues marked secret are keys to your account. Never share them or paste them into a chat.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"gramps-web": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"GRAMPS_API_URL",
"-e",
"GRAMPS_USERNAME",
"-e",
"GRAMPS_PASSWORD",
"-e",
"GRAMPS_REFRESH_TOKEN",
"-e",
"GRAMPS_TREE_ID",
"-e",
"GRAMPS_READ_ONLY",
"-e",
"GRAMPS_MUTATION_SERIALIZE",
"-e",
"GRAMPS_MUTATION_MIN_INTERVAL_MS",
"-e",
"GRAMPS_CONFIRMATION",
"-e",
"GRAMPS_LOG_LEVEL",
"-e",
"GRAMPS_MEDIA_RESOURCES_ENABLED",
"-e",
"GRAMPS_MEDIA_MAX_BYTES",
"-e",
"GRAMPS_MEDIA_ALLOW_PRIVATE",
"-e",
"GRAMPS_MEDIA_UPLOAD_DIRS",
"-e",
"GRAMPS_MEDIA_UPLOAD_MAX_BYTES",
"ghcr.io/scormave/gramps-web-mcp:2.9.1"
],
"env": {
"MCP_TRANSPORT": "your-value",
"GRAMPS_API_URL": "your-value",
"GRAMPS_USERNAME": "your-value",
"GRAMPS_PASSWORD": "your-value",
"GRAMPS_REFRESH_TOKEN": "your-value",
"GRAMPS_TREE_ID": "your-value",
"GRAMPS_READ_ONLY": "your-value",
"GRAMPS_MUTATION_SERIALIZE": "your-value",
"GRAMPS_MUTATION_MIN_INTERVAL_MS": "your-value",
"GRAMPS_CONFIRMATION": "your-value",
"GRAMPS_LOG_LEVEL": "your-value",
"GRAMPS_MEDIA_RESOURCES_ENABLED": "your-value",
"GRAMPS_MEDIA_MAX_BYTES": "your-value",
"GRAMPS_MEDIA_ALLOW_PRIVATE": "your-value",
"GRAMPS_MEDIA_UPLOAD_DIRS": "your-value",
"GRAMPS_MEDIA_UPLOAD_MAX_BYTES": "your-value"
}
}
}
}Run this in your terminal
claude mcp add gramps-web --env MCP_TRANSPORT=your-value --env GRAMPS_API_URL=your-value --env GRAMPS_USERNAME=your-value --env GRAMPS_PASSWORD=your-value --env GRAMPS_REFRESH_TOKEN=your-value --env GRAMPS_TREE_ID=your-value --env GRAMPS_READ_ONLY=your-value --env GRAMPS_MUTATION_SERIALIZE=your-value --env GRAMPS_MUTATION_MIN_INTERVAL_MS=your-value --env GRAMPS_CONFIRMATION=your-value --env GRAMPS_LOG_LEVEL=your-value --env GRAMPS_MEDIA_RESOURCES_ENABLED=your-value --env GRAMPS_MEDIA_MAX_BYTES=your-value --env GRAMPS_MEDIA_ALLOW_PRIVATE=your-value --env GRAMPS_MEDIA_UPLOAD_DIRS=your-value --env GRAMPS_MEDIA_UPLOAD_MAX_BYTES=your-value -- docker run -i --rm -e MCP_TRANSPORT -e GRAMPS_API_URL -e GRAMPS_USERNAME -e GRAMPS_PASSWORD -e GRAMPS_REFRESH_TOKEN -e GRAMPS_TREE_ID -e GRAMPS_READ_ONLY -e GRAMPS_MUTATION_SERIALIZE -e GRAMPS_MUTATION_MIN_INTERVAL_MS -e GRAMPS_CONFIRMATION -e GRAMPS_LOG_LEVEL -e GRAMPS_MEDIA_RESOURCES_ENABLED -e GRAMPS_MEDIA_MAX_BYTES -e GRAMPS_MEDIA_ALLOW_PRIVATE -e GRAMPS_MEDIA_UPLOAD_DIRS -e GRAMPS_MEDIA_UPLOAD_MAX_BYTES ghcr.io/scormave/gramps-web-mcp:2.9.1Fill in the empty values before running it.
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"gramps-web": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"GRAMPS_API_URL",
"-e",
"GRAMPS_USERNAME",
"-e",
"GRAMPS_PASSWORD",
"-e",
"GRAMPS_REFRESH_TOKEN",
"-e",
"GRAMPS_TREE_ID",
"-e",
"GRAMPS_READ_ONLY",
"-e",
"GRAMPS_MUTATION_SERIALIZE",
"-e",
"GRAMPS_MUTATION_MIN_INTERVAL_MS",
"-e",
"GRAMPS_CONFIRMATION",
"-e",
"GRAMPS_LOG_LEVEL",
"-e",
"GRAMPS_MEDIA_RESOURCES_ENABLED",
"-e",
"GRAMPS_MEDIA_MAX_BYTES",
"-e",
"GRAMPS_MEDIA_ALLOW_PRIVATE",
"-e",
"GRAMPS_MEDIA_UPLOAD_DIRS",
"-e",
"GRAMPS_MEDIA_UPLOAD_MAX_BYTES",
"ghcr.io/scormave/gramps-web-mcp:2.9.1"
],
"env": {
"MCP_TRANSPORT": "your-value",
"GRAMPS_API_URL": "your-value",
"GRAMPS_USERNAME": "your-value",
"GRAMPS_PASSWORD": "your-value",
"GRAMPS_REFRESH_TOKEN": "your-value",
"GRAMPS_TREE_ID": "your-value",
"GRAMPS_READ_ONLY": "your-value",
"GRAMPS_MUTATION_SERIALIZE": "your-value",
"GRAMPS_MUTATION_MIN_INTERVAL_MS": "your-value",
"GRAMPS_CONFIRMATION": "your-value",
"GRAMPS_LOG_LEVEL": "your-value",
"GRAMPS_MEDIA_RESOURCES_ENABLED": "your-value",
"GRAMPS_MEDIA_MAX_BYTES": "your-value",
"GRAMPS_MEDIA_ALLOW_PRIVATE": "your-value",
"GRAMPS_MEDIA_UPLOAD_DIRS": "your-value",
"GRAMPS_MEDIA_UPLOAD_MAX_BYTES": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"gramps-web": {
"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",
"-e",
"GRAMPS_TREE_ID",
"-e",
"GRAMPS_READ_ONLY",
"-e",
"GRAMPS_MUTATION_SERIALIZE",
"-e",
"GRAMPS_MUTATION_MIN_INTERVAL_MS",
"-e",
"GRAMPS_CONFIRMATION",
"-e",
"GRAMPS_LOG_LEVEL",
"-e",
"GRAMPS_MEDIA_RESOURCES_ENABLED",
"-e",
"GRAMPS_MEDIA_MAX_BYTES",
"-e",
"GRAMPS_MEDIA_ALLOW_PRIVATE",
"-e",
"GRAMPS_MEDIA_UPLOAD_DIRS",
"-e",
"GRAMPS_MEDIA_UPLOAD_MAX_BYTES",
"ghcr.io/scormave/gramps-web-mcp:2.9.1"
],
"env": {
"MCP_TRANSPORT": "your-value",
"GRAMPS_API_URL": "your-value",
"GRAMPS_USERNAME": "your-value",
"GRAMPS_PASSWORD": "your-value",
"GRAMPS_REFRESH_TOKEN": "your-value",
"GRAMPS_TREE_ID": "your-value",
"GRAMPS_READ_ONLY": "your-value",
"GRAMPS_MUTATION_SERIALIZE": "your-value",
"GRAMPS_MUTATION_MIN_INTERVAL_MS": "your-value",
"GRAMPS_CONFIRMATION": "your-value",
"GRAMPS_LOG_LEVEL": "your-value",
"GRAMPS_MEDIA_RESOURCES_ENABLED": "your-value",
"GRAMPS_MEDIA_MAX_BYTES": "your-value",
"GRAMPS_MEDIA_ALLOW_PRIVATE": "your-value",
"GRAMPS_MEDIA_UPLOAD_DIRS": "your-value",
"GRAMPS_MEDIA_UPLOAD_MAX_BYTES": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.
Your choice stays on this device in a cookie; no account needed.
MCP_TRANSPORT envGRAMPS_USERNAME envGRAMPS_READ_ONLY envGRAMPS_MUTATION_SERIALIZE envGRAMPS_MUTATION_MIN_INTERVAL_MS envGRAMPS_CONFIRMATION envGRAMPS_LOG_LEVEL envGRAMPS_MEDIA_RESOURCES_ENABLED envGRAMPS_MEDIA_MAX_BYTES envGRAMPS_MEDIA_ALLOW_PRIVATE envGRAMPS_MEDIA_UPLOAD_DIRS envGRAMPS_MEDIA_UPLOAD_MAX_BYTES envThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026
The registry name was verified with the GitHub account Scormave, which owns the repo
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: GRAMPS_API_URL, GRAMPS_PASSWORD, GRAMPS_REFRESH_TOKEN, GRAMPS_TREE_ID
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed –, and the latest version (2.9.1) reached the registry 4 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Docker on your computer.
In the same category: Spec Driven Development, Remote Desktop Commander, Happo
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Review Happo's visual and accessibility diffs: inspect comparisons, accept or reject, report flakes.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
[!WARNING]
Update to 2.3.1 or later. Before 2.3.1 the
update_*tools could drop
stored data that the call did not mention
(#5). If you edited a
tree with an earlier version,
check it for dropped data.
Companion MCP server for the Gramps Web open-source genealogy platform. It lets AI agents read and edit your family tree through the Model Context Protocol. It is not a genealogy UI: run it alongside an existing Gramps Web instance, where your users, trees, media and permissions stay.
[][install-vscode] [][install-vscode-insiders] [][install-cursor]
The buttons add the server to VS Code or Cursor, which start it from the Docker image, so Docker must be installed. For Claude Desktop, install the MCPB extension; other clients are listed under Install.
linkMode and keep the rest; save a whole register entry in one transaction with create_records; dates in every Gramps form and calendarfind_duplicates pairs people entered twice, across spellings and name forms, and the create tools refuse a person the tree already hasundo_change reverts one transaction of the edit history; it, delete_object and merge_objects ask the user, not the model, before they change the tree, in clients that support MCP elicitationThe tool catalog describes every tool, resource and prompt. Upgrading from 1.x? Follow the 2.0 migration guide.
Ask in your own words; the agent chooses the tools. The names stand for people in your tree, and a Gramps ID such as I0012 works as well.
| You ask | You get |
|---|---|
| "Tell me about Maria García." | Her names, events with dates and places, parents, spouses and children, citations and notes |
| "Who were Kenji Tanaka's great-grandparents?" | Each ancestor with a kinship label such as Father's mother, and birth and death dates and places |
| "How is Ivan Petrov related to Maria García?" | The relationship in words, such as second cousin once removed, and the common ancestors by name |
| "Transcribe the baptism scan O0012." | The scan for the agent to read, and the transcription in its reply |
| "Add Thomas Weber, born 3 May 1881 in Hamburg, son of Karl and Anna Weber." | The new records with their Gramps IDs, people already in the tree reused, and what the text left open |
| "Enter entry 12 of the 1884 marriage register: the couple, their fathers and the witnesses." | The citation, the marriage, the new people and families saved in one transaction, which one undo_change takes back |
| "What changed today? Undo the last edit." | The edit history, then the earlier versions back, or a refusal naming the later edits the undo would overwrite |
Reading scans needs media access. The tool catalog lists more requests and the tools each one uses.
You need a running Gramps Web instance and an account on it. Choose the setup by client:
| Client | Setup |
|---|---|
| Claude Desktop | The MCPB extension, installed from one file; no Docker |
| VS Code, Cursor | The install buttons above; the client starts the Docker image |
| Claude Code, Codex, Gemini CLI, Antigravity CLI, Open WebUI and others | Connecting MCP clients: over HTTP to a shared server, or started by the client from the Docker image or the release binary |
| Several clients or machines | One server in Docker, Docker Compose or on Unraid, reached over HTTP |
.mcpb bundle for your platform from the latest release, such as gramps-web-mcp-claude-desktop-osx-arm64-v*.mcpb for Apple Silicon.Claude Desktop connects to servers added by URL from Anthropic's cloud, not from your computer, so it cannot reach a server on your home network; use the extension there. Installation lists the bundle for each platform.
For one server that several clients share:
docker run -p 8080:8080 \
-e GRAMPS_API_URL=https://your-gramps.example.com \ -e GRAMPS_USERNAME=your-user \ -e GRAMPS_PASSWORD=your-password \ -e GRAMPS_TREE_ID=your-tree-uuid \ -e MCP_API_KEY=your-secret-api-key \ ghcr.io/scormave/gramps-web-mcp:latest
Clients then connect to http:// :8080/mcp with the API key, as shown in Over HTTP. Add -e GRAMPS_READ_ONLY=true for read-only mode. Installation covers refresh tokens, health checks, image verification, Docker Compose with Gramps Web, Unraid and upgrades.
Every setting is an environment variable. The main ones:
| Variable | Description | Default |
|---|---|---|
GRAMPS_API_URL | Base URL of your Gramps Web instance (no trailing slash) | — |
GRAMPS_USERNAME, GRAMPS_PASSWORD | The Gramps Web account the server works as | — |
GRAMPS_REFRESH_TOKEN | Used instead of the user name and password when Gramps Web has password login turned off | — |
GRAMPS_TREE_ID | Tree UUID on that server | — |
GRAMPS_READ_ONLY | true publishes only read tools and blocks writes | false (the Claude Desktop extension: true) |
GRAMPS_MEDIA_RESOURCES_ENABLED | Lets agents read scans and photos, and enables uploads | false |
GRAMPS_MEDIA_UPLOAD_DIRS | Folders that create_media may upload from | unset (off) |
MCP_TRANSPORT | stdio, http (Streamable HTTP) or sse | stdio (the Docker image: http) |
MCP_API_KEY | Key that HTTP clients must send; set it whenever other machines can reach the port | — |
Configuration describes every setting, including write pacing for SQLite, confirmation dialogs, media limits, transports, browser origins and logging.
| Document | Description |
|---|---|
| Installation | Claude Desktop, Docker, Docker Compose, Unraid, health checks, and upgrades |
| Connecting MCP clients | Claude Code, VS Code, Cursor, Codex, Gemini and Antigravity CLI, and Open WebUI, over HTTP or stdio |
| Configuration | Every environment variable |
| Tool catalog | Every tool, resource and prompt, and more example requests |
| System prompt | Suggested prompt for MCP clients |
| Migrating to 2.0 | Tool replacements and setup changes for 1.x users |
| Claude Desktop MCPB | Desktop extension packaging |
| Architecture | System design overview |
| Developer guide | Running from source, tests, and adding tools |
| docs index | All documentation files |
Contributions are welcome. ./run-local-server.sh runs the server from source against the public demo.grampsweb.org tree at http://127.0.0.1:8080/mcp, and dotnet test runs the tests. See CONTRIBUTING.md and the developer guide.
gramps-web-mcp is free and open source. If it helps your research, you can support its development through GitHub Sponsors, monthly or once. Sponsors whose tier includes a mention are listed here.
To report a vulnerability, see SECURITY.md.
The Claude Desktop extension is a local MCP server. It sends data only to the Gramps Web instance you configure and does not collect analytics or conversation data. See PRIVACY.md for full details.
Copyright (c) Scormave
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-or-later). Because this is network server software, hosting a modified version requires making the corresponding source available to users interacting with it over a network.
Bundled third-party components, such as ImageSharp, the MCP C# SDK, and the .NET runtime, keep their own Apache 2.0 or MIT licenses; see THIRD-PARTY-NOTICES.txt. The MCP Bundles and the Docker image ship that file next to LICENSE.
Only the beginning is shown; read the rest in the repo