Probandia MCPサーバー
コミット 2026年10月27日アーカイブの検索とGEDCOM 7のエクスポートを行い、Genealogical Proof Standard(系図学的証明基準)に基づいた系図調査をAIエージェントで実行できます。
別名 devohmycode/Probandia
- スター
- 0
- ツール
- 4
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年10月27日
- ライセンス
- Apache-2.0
Probandia MCPとは
アーカイブの検索とGEDCOM 7のエクスポートを行い、Genealogical Proof Standard(系図学的証明基準)に基づいた系図調査をAIエージェントで実行できます。 4個のツールを提供しており、dates, variants, placesなどがあります。
プロジェクトのREADMEから生成された概要
Probandia MCP server について
系図の研究者やAIコーディングエージェントを利用する開発者は、Probandiaを使用して厳格な家族史の調査を行うことができます。このシステムはGenealogical Proof Standardに従い、無料のオンラインリソースを使用して、調査計画の策定、アーカイブの閲覧、事実の検証を行います。エージェントが単純な質問から、完全な調査レポート、家系図、そしてGEDCOM 7エクスポートへと進むための構造化された手法を提供します。
ユーザーは、MCP serverを介するか、/probandia:newや/probandia:statusといった特定のスラッシュコマンドを使用してエンジンとやり取りできます。セットアップにはPython 3.11以降が必要で、WindowsおよびLinuxに対応しています。Claude CodeやGrok Buildはシェル経由でエンジンを使用しますが、Codex、Cursor、Claude Desktopなどの他のクライアントはMCP server経由で接続します。システムには、調査プロセスの異なる段階を管理するための7つの専門的なエージェントロールが含まれています。
できること
- 1家族史調査の自動化アーカイブ検索を使用して、特定の歴史的人物に関する親族関係をAIエージェントに調査させます。
- 2標準化された系図ファイルの生成家系図データを他の系図ソフトウェアにインポートするためのGEDCOM 7ファイルを作成します。
- 3歴史的事実の検証専門的なエージェントロールを使用して、すべての系図学的な結論が引用された証拠に基づいていることを確認します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Probandia MCPツール 4
READMEから検出datesvariantsplacescite
| dates | — | |
| variants | — | |
| places | — | |
| cite | — |
設定
PROBANDIA_PROJECT
| 名前 | 説明 | 種類 |
|---|---|---|
| PROBANDIA_PROJECT | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能devohmycode/probandia is public and reachablegithub.com/devohmycode/probandia ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-27github.com/devohmycode/probandia ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない4 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るProbandia
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のよくある質問
Probandia MCPが提供するツールは
4個のツールを提供しており、dates, variants, places, citeなどがあります。
Probandiaは何ができますか?
Probandiaは系図調査用プラグインです。調査計画の策定、アーカイブやウェブの閲覧、出典の引用、そして調査レポート、家系図、GEDCOM 7エクスポートの作成を行います。