Probandia MCP server
Commit 27. Okt. 2026Ermöglicht es AI Agents, Genealogie-Recherche unter Anwendung des Genealogical Proof Standard durchzuführen, indem Archive durchsucht und GEDCOM 7 Exporte generiert werden.
Auch bekannt als devohmycode/Probandia
- Stars
- 0
- Tools
- 4
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 27. Okt. 2026
- Lizenz
- Apache-2.0
Was ist Probandia MCP?
Ermöglicht es AI Agents, Genealogie-Recherche unter Anwendung des Genealogical Proof Standard durchzuführen, indem Archive durchsucht und GEDCOM 7 Exporte generiert werden. Er stellt 4 Tools bereit, etwa dates, variants, places.
Zusammenfassung generiert aus dem README des Projekts
Über Probandia MCP server
Genealogie-Forscher und Entwickler, die AI Coding Agents nutzen, können Probandia für fundierte Ahnenforschung verwenden. Das System folgt dem Genealogical Proof Standard, um Suchen zu planen, Archive zu lesen und Fakten mithilfe kostenloser Online-Ressourcen zu verifizieren. Es bietet einen strukturierten Weg für Agents, von einer einfachen Frage zu einem vollständigen Forschungsbericht, einem Stammbaum und einem GEDCOM 7 Export zu gelangen.
Nutzer können mit der Engine über einen MCP server oder über spezifische Slash-Commands wie /probandia:new und /probandia:status interagieren. Das Setup erfordert Python 3.11 oder neuer und ist mit Windows und Linux kompatibel. Während Claude Code und Grok Build die Engine über die Shell nutzen, verbinden sich andere Clients wie Codex, Cursor und Claude Desktop über den MCP server. Das System umfasst sieben spezialisierte Agent-Rollen, um die verschiedenen Phasen des Forschungsprozesses zu verwalten.
Was du damit machen kannst
- 1Automatisierte AhnenforschungFordere einen AI Agent auf, die Abstammung einer bestimmten historischen Person mithilfe von Archivrecherchen zu untersuchen.
- 2Erstellung standardisierter Genealogie-DateienErstelle eine GEDCOM 7 Datei, um Stammbaumdaten in andere Genealogie-Software zu importieren.
- 3Verifizierung historischer BehauptungenNutze spezialisierte Agent-Rollen, um sicherzustellen, dass alle genealogischen Schlussfolgerungen durch zitierte Belege gestützt werden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Probandia MCP tools 4
Erkannt aus dem READMEdatesvariantsplacescite
| dates | — | |
| variants | — | |
| places | — | |
| cite | — |
Konfiguration
PROBANDIA_PROJECT
| Name | Beschreibung | Typ |
|---|---|---|
| PROBANDIA_PROJECT | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbardevohmycode/probandia is public and reachablegithub.com/devohmycode/probandia ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-27github.com/devohmycode/probandia ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenProbandia
Nothing is concluded until it is proven.
A genealogy research plugin for AI coding agents. Ask your agent a question
about a family; Probandia runs the research by the Genealogical Proof Standard:
it plans the searches, reads the archives and the web on free resources only,
cites every fact on its source, and writes a report, a tree and a GEDCOM 7
export. The plugin brings slash commands (/probandia:new, /probandia:resume,
/probandia:status…), skills, seven agent roles, hooks that keep the rules, and
an MCP server (not in Claude Code, Grok Build and Factory Droid, whose skills
call the engine through the shell); the plugin surface
lists them all. Its engine, run_probandia.py, needs only Python 3.11 or later.
English · Français · French user guide: guide d'utilisation.
Contents: How it works · Requirements · Install the plugin · Install the command · First research · Use the command · Command reference · The plugin surface · Projects and settings · Model and effort of each agent · Privacy and security · Proving a conclusion · Providers · The terminal interface · Development
How it works
Your coding agent loads the plugin; its commands, skills and agents call the engine through the
probandia command, or through its MCP server. The engine plans, proves and verifies; it writes
the research project, searches the archives through its providers and renders the report.
Requirements
- Systems: Windows and Linux, tested by the CI at each change (Windows with Python 3.11 and 3.14, Ubuntu with Python 3.11, 3.12, 3.13 and 3.14). macOS: not tested.
- Python 3.11 or later, callable as
python: the hooks of Claude Code and Codex takepython, elsepython3(on Windows,pythononly; Claude Code runs them in Git Bash there); the MCP server and the hooks of Cursor and Antigravity runpython, with no fallback.probandia doctorsays whenpythonis missing. On Debian or Ubuntu,sudo apt install python-is-python3gives that name; on Windows, the installer of python.org with "Add python.exe to PATH". - Claude Code on Windows: Git Bash. Without it, Claude Code runs the hooks
in PowerShell, where they fail: install Git for Windows, or point
CLAUDE_CODE_GIT_BASH_PATHto itsbash.exe.probandia doctorsays when it finds none (GIT_BASH=missing). - Nothing else is needed: the engine uses the standard library and carries its
few dependencies in
src/probandia/_vendor.
On Windows, from PowerShell
Python and Git for Windows (which brings Git Bash), then close and reopen
PowerShell so that the PATH is read again:
winget install -e --id Python.Python.3.14
winget install -e --id Git.Git --source winget
python --version
If python opens the Microsoft Store instead, open Manage app execution
aliases from the Start menu and turn off the Python aliases. Without winget, the installers of
python.org (tick "Add python.exe
to PATH") and git-scm.com do the same.
Then the CLI of your harness, each from its own documentation (read on 25 October 2026):
| Agent CLI | Install on Windows (PowerShell) | Documentation |
|---|---|---|
| Claude Code | irm https://claude.ai/install.ps1 | iex, or winget install Anthropic.ClaudeCode |
code.claude.com |
| Codex | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex", or npm install -g @openai/codex |
github.com/openai/codex |
| Cursor (CLI) | irm 'https://cursor.com/install?win32=true' | iex |
cursor.com |
| Factory Droid | irm https://app.factory.ai/cli/windows | iex |
github.com/Factory-AI/factory |
| Grok Build | irm https://x.ai/cli/install.ps1 | iex |
docs.x.ai |
| Antigravity | irm https://antigravity.google/cli/install.ps1 | iex |
github.com/google-antigravity/antigravity-cli |
| OpenCode | npm install -g opencode-ai (Node.js first: winget install OpenJS.NodeJS.LTS), or scoop install opencode; its documentation advises WSL on Windows |
opencode.ai |
Optional tools, which probandia doctor checks and installs nothing itself:
| Tool | What for | Install |
|---|---|---|
| Playwright | a headless browser, for pages that need one, when your agent drives no browser of yours (see Archives behind a sign-in) | python -m pip install playwright && python -m playwright install chromium |
| Tesseract | OCR of printed records (transcribe ocr) |
Windows: winget install UB-Mannheim.TesseractOCR or scoop install tesseract; Linux: sudo apt install tesseract-ocr tesseract-ocr-fra; macOS: brew install tesseract tesseract-lang |
| Pillow | sheets of views, crops and turns of images (image) |
python -m pip install "Pillow>=12,<13", or the images extra (below) |
Install the plugin
The repository, https://github.com/devohmycode/probandia, is both the plugin
and its marketplace. Claude Code, Grok Build and Factory Droid install it
straight from GitHub. Codex, Antigravity, OpenCode and Claude Desktop install it
from a clone, whose folder is <path> below:
git clone https://github.com/devohmycode/probandia
cd probandia
On Windows, clone it into a short folder (C:\Users\<you>\probandia, not a
deep one): a few files of bench/ have paths of 163 characters, and Windows
refuses paths longer than 260.
| Harness | Support | MCP server | Install |
|---|---|---|---|
| Claude Code (terminal, IDE, desktop app) | full | no: its skills call the engine through the shell | /plugin marketplace add devohmycode/probandia |
| Grok Build | full | no: it reads .claude-plugin/ |
grok plugin install devohmycode/probandia --trust |
| Codex | full | yes (mcp.json) |
codex plugin marketplace add <path>, then install --harness codex (plugin and seven agents) |
| Cursor | full | yes (cursor/mcp.json) |
git clone into ~/.cursor/plugins/local/probandia |
| Factory Droid | full | no: the plugin root is not expanded in its MCP settings | droid plugin marketplace add https://github.com/devohmycode/probandia |
| Antigravity | beta | yes (mcp_config.json) |
agy plugin install <path> |
| OpenCode | reduced | yes, merged into opencode.json |
install --harness opencode |
| Claude Desktop (chat) | MCP server only | yes, the only part | claude_desktop_config.json |
Each section says when, and with which version, it was replayed.
Every way runs the engine from the repository's folder: keep it where it is,
and update it (git pull) before updating the plugin.
Claude Code
Full support, without the MCP server. Verified on 21 October 2026 with Claude Code 2.1.304 and 2.1.306, in a
configuration of its own (CLAUDE_CONFIG_DIR): install from the repository's
folder, a research run to its end, update and uninstall, which leaves
"enabledPlugins": {} and Claude Code's copy of the plugin in its cache;
the MCP server alone was listed connected, then removed. Verified on 24 October
2026 with Claude Code 2.1.306, from GitHub: marketplace added, plugin
installed (1.0.0) and enabled, marketplace updated, then both removed. In a
session (or the same words after claude plugin in a terminal):
Install, from GitHub:
/plugin marketplace add devohmycode/probandia
/plugin install probandia@probandia
From a clone, the first line is /plugin marketplace add <path>.
Update:
/plugin marketplace update probandia
/plugin update probandia@probandia
Uninstall:
/plugin uninstall probandia@probandia
/plugin marketplace remove probandia
Run a research:
/probandia:new "Who were the parents of Victor Hugo, born in 1802 in Besançon?"
claude --plugin-dir <path> loads the folder for one session, without
installing it.
The MCP server alone, without the plugin: the engine's 17 tools in Claude Code, without the slash commands, skills, agents or hooks. Declare it from the project's folder:
claude mcp add probandia -- python <path>/run_probandia.py mcp
Without the repository, from PyPI:
claude mcp add probandia -- uvx probandia mcp (on Windows, cmd /c uvx
instead of uvx). claude mcp remove probandia takes it out.
Grok Build
Full support, without the MCP server: Grok Build reads the Claude Code layout
(.claude-plugin/). Its plugin options (/config) are ignored: settings come
from the files (see Projects and settings).
Verified on 17 October 2026 with Grok Build 1.0.62: install from the
repository's folder, doctor run in the harness names it, the status command
answers STATUS=OK, and the uninstall leaves its configuration files as they
were.
Install, from GitHub (grok plugin install takes a git URL, user/repo or a
local path):
grok plugin install devohmycode/probandia --trust
From a clone: grok plugin install <path> --trust.
Update: installed from GitHub, this command fetches the new version. A local
path is installed as a link, so git pull in <path> is enough, and the same
command says so:
grok plugin update probandia
Uninstall:
grok plugin uninstall probandia
Run a research (the form of /probandia:status, verified):
/probandia:new "Who were the parents of Victor Hugo, born in 1802 in Besançon?"
Codex
Full support, with the MCP server. Codex plugins hold skills but no subagents:
the installer also writes the seven roles as custom agents. Run it from your
research project's folder (or pass --path <project-folder>).
Verified on 17 October 2026 with Codex 0.161.0: install from the repository's
folder, doctor run in the harness names it, the status command answers
STATUS=OK, and the uninstall leaves its configuration files as they were.
Verified on 21 October 2026 with Codex 0.161.0, in a new project: the
marketplace added as below is listed, the plugin is installed and enabled, the
reader agent starts, and the contradictor runs the engine in its read-only
sandbox.
Install: add the repository as a marketplace (Codex reads none from a project's settings), write the agents, then add the plugin, from the project's folder:
codex plugin marketplace add <path>
python <path>/run_probandia.py install --harness codex
codex plugin add probandia@probandia
The first command writes the marketplace into your Codex settings
(~/.codex/config.toml); the installer enables the plugin in the project's
.codex/config.toml and writes the seven custom agents as
.codex/agents/probandia-<role>.toml. Existing Codex settings are kept. Reopen Codex in this folder, trust the project, and start a
new chat; approve the plugin hooks in /hooks if Codex asks. The agents use
Codex's TOML format (name, description, developer_instructions,
model_reasoning_effort), inherit your model unless you chose one (see
Model and effort of each agent), and set the
contradictor to sandbox_mode = "read-only". See the official
custom agent format
and project plugin configuration.
If you installed the plugin through Codex's marketplace already,
install --harness codex-agents installs only the roles.
Update: git pull in <path>, then the same command again, which
rewrites the agents:
python <path>/run_probandia.py install --harness codex
Uninstall: codex plugin remove takes the plugin out of ~/.codex/config.toml
and of Codex's cache, --uninstall removes what the installer wrote, and the
last command takes the marketplace out of your settings:
codex plugin remove probandia@probandia
python <path>/run_probandia.py install --harness codex --uninstall
codex plugin marketplace remove probandia
Run a research (the same request for status, verified): the Codex plugin
brings skills, not slash
commands; ask in the chat, and the engine skill runs new:
Start a Probandia research: who were the parents of Victor Hugo, born in 1802 in Besançon?
Cursor
Full support, with the MCP server (cursor/mcp.json). Cursor loads a local
plugin from ~/.cursor/plugins/local/<name>, a folder of its own: it rejects
a link to a folder elsewhere ("symlink target … is outside"). Then restart
Cursor, or run "Developer: Reload Window" (on Teams and Enterprise, an admin
must allow local plugin imports). cursor-agent --plugin-dir <path> loads the
folder for one session.
Cursor shows a plugin's commands only while its option for third-party
plugins, skills and other configs is on. With that option on, it also imports
the plugins of Claude Code: when Probandia is installed there too, disable it
in Claude Code (claude plugin disable probandia@probandia), or Cursor shows
that copy (its commands without a prefix, /status) instead of this one.
Verified on 22 October 2026 with Cursor 3.27.6 (the editor): installed as a
clone, Cursor lists it as a local plugin (0.9.41) with its 19 commands, and
/probandia-status is offered in the chat; on 21 October 2026, with Cursor
3.26.13, the MCP server listed its 17 tools and dates answered, doctor
named Cursor, and a fork there left the original as it was.
Install, a clone of the repository:
git clone https://github.com/devohmycode/probandia ~/.cursor/plugins/local/probandia
git clone https://github.com/devohmycode/probandia "$HOME\.cursor\plugins\local\probandia"
Update: git pull in the clone, then reload the window:
git -C ~/.cursor/plugins/local/probandia pull
Uninstall: remove the clone:
rm -rf ~/.cursor/plugins/local/probandia
Remove-Item -Recurse -Force "$HOME\.cursor\plugins\local\probandia"
Run a research. Cursor names a plugin's commands without a prefix, so
Probandia's carry one (cursor/commands/), away from Cursor's own and other
plugins' (/probandia-status, /probandia-resume…):
/probandia-new "Who were the parents of Victor Hugo, born in 1802 in Besançon?"
Factory Droid
Full support, without the MCP server: the plugin root is not expanded in
Droid's MCP settings, so the skills call the engine through the shell. Droid
reads the repository's marketplace (.claude-plugin/marketplace.json), and
names it after the folder: for a folder not named probandia, write
probandia@<folder-name> and marketplace remove <folder-name> below.
Verified on 17 October 2026 with Factory Droid 0.242.0: install from the
repository's folder, doctor run in the harness names it, the status command
answers STATUS=OK, and the uninstall takes everything out but an empty
"enabledPlugins": {} in ~/.factory/settings.json and empty folders in
~/.factory/plugins/cache/. The update was verified on 21 October 2026 with Factory
Droid 0.245.1.
Install, from GitHub:
droid plugin marketplace add https://github.com/devohmycode/probandia
droid plugin install probandia@probandia --scope user
From a clone: droid plugin marketplace add <path>.
Update:
droid plugin marketplace update probandia
droid plugin update probandia@probandia --scope user
Uninstall:
droid plugin uninstall probandia@probandia --scope user
droid plugin marketplace remove probandia
Run a research (verified on 21 October 2026: asked in words, it runs the
command file; droid exec does not expand slash commands), as Droid names a command file
(commands/new.md becomes /new). Droid reads a plugin's commands from its
commands/ folder only, shared with Claude Code: they keep their short names
(/new, /status, /resume…), which a command of Droid's own or of another
plugin may take first; then ask in words ("run Probandia's status"). Otherwise:
/new "Who were the parents of Victor Hugo, born in 1802 in Besançon?"
Antigravity
Beta support, with the MCP server, declared in mcp_config.json (the root
plugin.json declares none). Antigravity starts the server in the plugin's
folder: the server then asks the client for its roots (MCP roots/list) and
works in the first one that holds a project.
Verified on 17 October 2026 with Antigravity 1.4.0: install from the
repository's folder, doctor run in the harness names it, the status command
answers STATUS=OK, and the uninstall leaves its configuration files as they
were. Its install reported "agents: skipped (not found)": since 23 October 2026
(agy 1.4.6), agy plugin validate . counts the seven agents of agents/, which
take the session's model.
Install:
agy plugin install <path>
Update: git pull in <path>, then install again:
agy plugin install <path>
Uninstall:
agy plugin uninstall probandia
Run a research (the form of /status, verified):
/new "Who were the parents of Victor Hugo, born in 1802 in Besançon?"
OpenCode
Reduced support, with the MCP server. OpenCode has no package format: the
installer copies the skills, the agents and the commands (as
probandia-<name>.md), merges the MCP server into opencode.json (keeping a
.bak copy) and adds a small JS plugin for the hooks.
Verified on 17 October 2026 with OpenCode 1.18.29: install from the
repository's folder, doctor run in the harness names it, the status command
answers STATUS=OK, and the uninstall leaves its configuration files as they
were (--scope user; the skills go to ~/.agents/skills/).
Install, for your user or for the current project:
python <path>/run_probandia.py install --harness opencode
python <path>/run_probandia.py install --harness opencode --scope project
Update: git pull in <path>, then the same command again:
python <path>/run_probandia.py install --harness opencode
Uninstall, with the same --scope as the install:
python <path>/run_probandia.py install --harness opencode --uninstall
Run a research (the form of /probandia-status, verified):
/probandia-new "Who were the parents of Victor Hugo, born in 1802 in Besançon?"
Claude Desktop
The MCP server only: Claude Desktop (the chat, not Claude Code) runs MCP
servers but no plugin. It gets the engine's tools (search, read, what is
known, verify…) without the slash commands, skills, agents or hooks. Verified on
21 October 2026: added to claude_desktop_config.json, its dates tool
answers in a chat; removed, after a restart.
Install: add the server to claude_desktop_config.json
(Settings › Developer › Edit Config), with the project folder it works in, then
restart Claude Desktop:
{
"mcpServers": {
"probandia": {
"command": "python",
"args": ["<path>/run_probandia.py", "mcp"],
"env": {"PROBANDIA_PROJECT": "<the folder that holds probandia.toml>"}
}
}
}
Update: git pull in <path>, then restart Claude Desktop:
git -C <path> pull
Uninstall: remove the "probandia" entry from mcpServers,
then restart Claude Desktop:
{
"mcpServers": {}
}
Run a research: MCP tools only. Ask in the chat; Claude calls the tools of
the MCP server (plan, search, read, propose,
verify…) in the project of PROBANDIA_PROJECT.
What --uninstall does
Each install --harness records what it wrote, in .probandia-install.json
(in .codex/ for Codex; in OpenCode's configuration folder, or the project's,
for OpenCode). --uninstall reads that record and:
- deletes each file the install created, even one you edited since;
- takes Probandia's keys out of the settings it shares with you
(
.codex/config.toml,opencode.json) and keeps every other key, even one you added after the install; when no one changed that file since the install, it puts back the.bakcopy made before it; - removes the folders the install created, when they are empty.
Installed files name the engine by its absolute path: install again if you
move the repository. python <path>/run_probandia.py doctor checks the harness,
the keys, Python and the optional tools.
Probandia MCP Fragen
Welche Tools bietet Probandia MCP?
Er stellt 4 Tools bereit, darunter dates, variants, places, cite.
Was macht Probandia?
Es ist ein Plugin für die Genealogie-Recherche, das Suchen plant, Archive und das Web auswertet, Quellen zitiert und Forschungsberichte, Stammbäume sowie GEDCOM 7 Exporte erstellt.