German Archives (DDB; BW, NRW, Rhineland-Palatinate and Hesse registers)

io.github.ianderso/german-archives-mcp · v0.3.0

German archive finding aids (DDB); civil and church registers of BW, NRW, RLP and Hesse.

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add german-archives-mcp -e GERMAN_ARCHIVES_CACHE_DIR=<GERMAN_ARCHIVES_CACHE_DIR> -e GERMAN_ARCHIVES_TIMEOUT=<GERMAN_ARCHIVES_TIMEOUT> -e GERMAN_ARCHIVES_MIN_INTERVAL=<GERMAN_ARCHIVES_MIN_INTERVAL> -e GERMAN_ARCHIVES_CONTACT=<GERMAN_ARCHIVES_CONTACT> -e GERMAN_ARCHIVES_DOWNLOAD_DIR=<GERMAN_ARCHIVES_DOWNLOAD_DIR> -e GERMAN_ARCHIVES_PDF_CACHE_DAYS=<GERMAN_ARCHIVES_PDF_CACHE_DAYS> -e GERMAN_ARCHIVES_PDF_CACHE_MB=<GERMAN_ARCHIVES_PDF_CACHE_MB> -- uvx german-archives-mcp==0.3.0

claude_desktop_config.json

{
  "mcpServers": {
    "german-archives-mcp": {
      "command": "uvx",
      "args": [
        "german-archives-mcp==0.3.0"
      ],
      "env": {
        "GERMAN_ARCHIVES_CACHE_DIR": "<GERMAN_ARCHIVES_CACHE_DIR>",
        "GERMAN_ARCHIVES_TIMEOUT": "<GERMAN_ARCHIVES_TIMEOUT>",
        "GERMAN_ARCHIVES_MIN_INTERVAL": "<GERMAN_ARCHIVES_MIN_INTERVAL>",
        "GERMAN_ARCHIVES_CONTACT": "<GERMAN_ARCHIVES_CONTACT>",
        "GERMAN_ARCHIVES_DOWNLOAD_DIR": "<GERMAN_ARCHIVES_DOWNLOAD_DIR>",
        "GERMAN_ARCHIVES_PDF_CACHE_DAYS": "<GERMAN_ARCHIVES_PDF_CACHE_DAYS>",
        "GERMAN_ARCHIVES_PDF_CACHE_MB": "<GERMAN_ARCHIVES_PDF_CACHE_MB>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "german-archives-mcp": {
      "command": "uvx",
      "args": [
        "german-archives-mcp==0.3.0"
      ],
      "env": {
        "GERMAN_ARCHIVES_CACHE_DIR": "<GERMAN_ARCHIVES_CACHE_DIR>",
        "GERMAN_ARCHIVES_TIMEOUT": "<GERMAN_ARCHIVES_TIMEOUT>",
        "GERMAN_ARCHIVES_MIN_INTERVAL": "<GERMAN_ARCHIVES_MIN_INTERVAL>",
        "GERMAN_ARCHIVES_CONTACT": "<GERMAN_ARCHIVES_CONTACT>",
        "GERMAN_ARCHIVES_DOWNLOAD_DIR": "<GERMAN_ARCHIVES_DOWNLOAD_DIR>",
        "GERMAN_ARCHIVES_PDF_CACHE_DAYS": "<GERMAN_ARCHIVES_PDF_CACHE_DAYS>",
        "GERMAN_ARCHIVES_PDF_CACHE_MB": "<GERMAN_ARCHIVES_PDF_CACHE_MB>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "german-archives-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "german-archives-mcp==0.3.0"
      ],
      "env": {
        "GERMAN_ARCHIVES_CACHE_DIR": "<GERMAN_ARCHIVES_CACHE_DIR>",
        "GERMAN_ARCHIVES_TIMEOUT": "<GERMAN_ARCHIVES_TIMEOUT>",
        "GERMAN_ARCHIVES_MIN_INTERVAL": "<GERMAN_ARCHIVES_MIN_INTERVAL>",
        "GERMAN_ARCHIVES_CONTACT": "<GERMAN_ARCHIVES_CONTACT>",
        "GERMAN_ARCHIVES_DOWNLOAD_DIR": "<GERMAN_ARCHIVES_DOWNLOAD_DIR>",
        "GERMAN_ARCHIVES_PDF_CACHE_DAYS": "<GERMAN_ARCHIVES_PDF_CACHE_DAYS>",
        "GERMAN_ARCHIVES_PDF_CACHE_MB": "<GERMAN_ARCHIVES_PDF_CACHE_MB>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`GERMAN_ARCHIVES_CACHE_DIR` Optional	Directory for the on-disk response cache, and for the APERTUS volume PDFs kept for reading further pages.
`GERMAN_ARCHIVES_TIMEOUT` Optional	HTTP timeout in seconds for one request. Image downloads get 120 s to read.
`GERMAN_ARCHIVES_MIN_INTERVAL` Optional	Least seconds between two requests to one host. Never below 2; database searches and APERTUS volume downloads wait 10.
`GERMAN_ARCHIVES_CONTACT` Optional	An email address or URL appended to the User-Agent, so an archive can reach whoever runs the server.
`GERMAN_ARCHIVES_DOWNLOAD_DIR` Optional	An existing folder. When set, the image tools save only inside it; needed to save under ~/Library, such as an iCloud Drive folder.
`GERMAN_ARCHIVES_PDF_CACHE_DAYS` Optional	Days a downloaded APERTUS volume PDF is kept for reading further pages (at most 30).
`GERMAN_ARCHIVES_PDF_CACHE_MB` Optional	Most megabytes of APERTUS volume PDFs kept on disk; the least recently read go first (at least 100).

Details

Package	`[email protected]` (PYPI, stdio)
First published	11 Oct 2026
Last updated	11 Oct 2026
Registry name	`io.github.ianderso/german-archives-mcp`

More other servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use German Archives (DDB; BW, NRW, Rhineland-Palatinate and Hesse registers) often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-ianderso-german-archives-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-ianderso-german-archives-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.