Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
作者による説明(英語の原文)
MCP server for structured access to Gramps Web genealogy data
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
使っているAIアプリを選んで、設定をコピーしてください。
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「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、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"
}
}
}
}ターミナルでこれを実行します
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動かす前に、空欄の値を入力してください。
プロジェクトの .cursor/mcp.json、または ~/.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"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
プロジェクトの .vscode/mcp.json に貼り付けます
{
"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"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
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 envこの設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント Scormave で確認済みです
このリポジトリはまだGitHubから読み取っていません
このリポジトリはまだGitHubから読み取っていません
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:GRAMPS_API_URL, GRAMPS_PASSWORD, GRAMPS_REFRESH_TOKEN, GRAMPS_TREE_ID
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は–、最新バージョン(2.9.1)がレジストリに届いたのは4 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDockerも必要です。
同じカテゴリには:Spec Driven Development, Remote Desktop Commander, Date Math
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
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.
Exact date/time math for agents: business days, holidays, time zones, cron, RRULE, SLA. x402 paid.
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
[!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.
冒頭だけを表示しています。続きはリポジトリで読めます