Gramps Web MCP

Name: Gramps Web MCP
Author: Scormave

von ScormaveVersion 2.9.1i★ –iLäuft auf deinem Computer

Name in der Registryio.github.Scormave/gramps-web-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

MCP server for structured access to Gramps Web genealogy data

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges
Das musst du eintragen: GRAMPS_API_URL, GRAMPS_PASSWORD, GRAMPS_REFRESH_TOKEN, GRAMPS_TREE_ID

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: 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_BYTES

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

DockerDocker installiert

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "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"
      }
    }
  }
}

Führe das in deinem Terminal aus

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.1

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "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"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "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"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

MCP_TRANSPORT env
Pinned to stdio for registry-installed containers that the client spawns itself. The image's own default is http (Streamable HTTP on port 8080) for networked Docker deployments; see the README for th…
GRAMPS_API_URL erforderlich env
Base URL of your Gramps Web instance
GRAMPS_USERNAME env
Gramps Web API username; required with GRAMPS_PASSWORD unless GRAMPS_REFRESH_TOKEN is set
GRAMPS_PASSWORD geheim env
Gramps Web API password; required with GRAMPS_USERNAME unless GRAMPS_REFRESH_TOKEN is set
GRAMPS_REFRESH_TOKEN geheim env
Refresh token for instances with password login disabled; replaces GRAMPS_USERNAME and GRAMPS_PASSWORD
GRAMPS_TREE_ID erforderlich env
Gramps Web tree UUID
GRAMPS_READ_ONLY env
Set to true to block create, update, and delete tools
GRAMPS_MUTATION_SERIALIZE env
Serialize create/update/delete HTTP calls in-process (set false to allow parallel writes)
GRAMPS_MUTATION_MIN_INTERVAL_MS env
Minimum milliseconds between mutation HTTP calls. Use 250 or 500 on SQLite if you see database is locked
GRAMPS_CONFIRMATION env
Whether delete_object, merge_objects and undo_change ask the user to confirm through MCP elicitation: when-supported, required (refuse in clients that cannot ask), or off
GRAMPS_LOG_LEVEL env
Server log level: Trace, Debug, Information, Warning, Error, Critical, or None. Debug and Trace also log request and response bodies, which contain genealogy data
GRAMPS_MEDIA_RESOURCES_ENABLED env
Set to true to expose read_media and the media resources for thumbnails and full files, and to allow uploads from GRAMPS_MEDIA_UPLOAD_DIRS
GRAMPS_MEDIA_MAX_BYTES env
Maximum bytes returned by read_media or a media resource
GRAMPS_MEDIA_ALLOW_PRIVATE env
Set to true to return bytes for media records marked private
GRAMPS_MEDIA_UPLOAD_DIRS env
Absolute folders, separated by : (; on Windows), that create_media and update_media may upload photos, scans and PDFs from while GRAMPS_MEDIA_RESOURCES_ENABLED is true. Unset turns uploading off and…
GRAMPS_MEDIA_UPLOAD_MAX_BYTES env
Largest file create_media or update_media uploads

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto Scormave bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 32706 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 90 % der anderen 32706 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 32706 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Gramps Web MCP sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: GRAMPS_API_URL, GRAMPS_PASSWORD, GRAMPS_REFRESH_TOKEN, GRAMPS_TREE_ID

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (2.9.1) kam vor 4 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, Kanal Varna — drains, leaks & plumbing (Varna, BG)

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten

Installieren

Remote Desktop Commander

von desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Läuft in der Cloud★ 211Aktualisiert vorgestern

Installieren

Kanal Varna — drains, leaks & plumbing (Varna, BG)

von kanalvarna.com

Drain unblocking, leak detection & plumbing in Varna, Bulgaria: services, prices, areas, contact

Läuft in der CloudAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

gramps-web-mcp

[!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.

Features

Up to 35 MCP tools — read, create, update, merge, and delete people, families, events, places, sources, citations, notes, media, repositories, and tags
Search and kinship — full-text search, listings filtered by Gramps QL or Gramps filter rules, ancestors, descendants, relationships, and timelines
Careful edits — add or remove one link with linkMode and keep the rest; save a whole register entry in one transaction with create_records; dates in every Gramps form and calendar
Duplicates — find_duplicates pairs people entered twice, across spellings and name forms, and the create tools refuse a person the tree already has
Undo and confirmation — undo_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 elicitation
Scans and photos — opt-in previews that vision-capable agents can read, with EXIF/GPS metadata stripped, and uploads from a folder you choose
8 MCP resources and guided prompts — type vocabularies, tree metadata, filter rules, and workflows for research, imports, citing facts, and tree audits
Read-only mode — publish only read tools and block direct mutation calls
Any MCP client — stdio, Streamable HTTP, and legacy SSE, from a Claude Desktop extension, a Docker image, or a single-file release binary

The tool catalog describes every tool, resource and prompt. Upgrading from 1.x? Follow the 2.0 migration guide.

What to ask

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.

Install

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

Claude Desktop

Download the .mcpb bundle for your platform from the latest release, such as gramps-web-mcp-claude-desktop-osx-arm64-v*.mcpb for Apple Silicon.
Double-click it, or drag it into the Claude Desktop window.
Enter your Gramps Web URL, username, password/token, and tree UUID.
Leave Read-only mode enabled for your first session; disable it only when you want Claude to create or edit records.
Complete installation and start a new chat.

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.

Docker

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.

Configuration

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.

Documentation

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

Contributing

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.

Security

To report a vulnerability, see SECURITY.md.

Privacy Policy

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.

License

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.

Nur der Anfang wird gezeigt; den Rest findest du im Repo

Gramps Web MCP

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

Kanal Varna — drains, leaks & plumbing (Varna, BG)

README vom Entwickler

gramps-web-mcp

Features

What to ask

Install

Claude Desktop

Docker

Configuration

Documentation

Contributing

Sponsors

Security

Privacy Policy

License