OpenHeritage Public Search

io.github.OpenHeritageOnline由 GitHub 帳號 OpenHeritageOnline 發布v2.11.3更新於 Oct 24, 2026

Read-only OpenHeritage search for genealogy and cultural heritage records.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取知識與記憶

概覽

AI 產生的概覽

匿名、唯讀的遠端 MCP 伺服器，用來檢索 OpenHeritage 公開的烏克蘭族譜與文化遺產紀錄。

可以做什麼
  • 跨實體類型檢索公開紀錄，包括紀念檔案、墓園、來源、文獻、資料庫、作者與合集
  • 依關鍵字與語意檢索文獻頁面的轉錄文字，每筆結果連結到對應頁面
  • 依文字、前綴、類型或附近座標查找並自動補全標準地名，可選擇依日期解析歷史脈絡
  • 依穩定 ID 讀取單一標準地名
適用情境
適合助理需要查找烏克蘭的紀念檔案、墓穴、墓園或檔案文獻紀錄，或定位歷史地名，作為族譜與文化遺產研究的線索來源。
執行需求
透過 Streamable HTTP 連線的遠端 MCP 端點；公開檢索不需要 API 金鑰或帳號。需要能連上 OpenHeritage 服務的網路。
安裝前請注意
檢索結果只是線索，不能當作身分或親屬關係的證明；應尊重紀錄的可見性與著作權，避免爬取或大量列舉紀錄。此 MCP 伺服器不接受 Personal API 權杖，也不應把另一套 Personal API 的權杖傳送給它。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 OpenHeritage Public Search，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.OpenHeritageOnline%2Fpublic-search/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "openheritage-public-search": {
      "type": "http",
      "url": "https://openheritage.online/mcp"
    }
  }
}

README

OpenHeritage agent tooling

Public, cross-agent integration files for OpenHeritage, a collaborative genealogy and cultural-heritage platform.

OpenHeritage brings together Ukraine's largest public collection of memorial, grave, and archival document data.

This repository connects compatible AI agents to OpenHeritage in three complementary ways:

  • a remote, anonymous, read-only MCP server for live public-record search;
  • seven portable Agent Skills with domain guidance, safe REST fallbacks, and canonical OpenHeritage links;
  • a documented Personal API for user-authorized contributions with scoped bearer tokens.

No API key is required for public search.

Ukrainian heritage data at scale

  • Memorials and graves: discover memorial profiles, grave sites, cemetery records, cemetery photographs, map locations, and transcriptions.
  • Archival documents: search repositories and sources, retrieve digitized documents by page or original file, and use XML, transcriptions, parsing, or OCR to answer questions with provenance.

These records are connected through canonical OpenHeritage pages, so agents can move from a discovery lead to the relevant cemetery, memorial, source, or document without treating search results as proof.

MCP endpoint

text
https://openheritage.online/mcp

The endpoint uses MCP Streamable HTTP and exposes:

  • search_records
  • search_memorials
  • search_cemeteries
  • search_sources
  • search_documents
  • search_repositories
  • search_places
  • search_authors
  • search_collections

The MCP server also exposes anonymous, read-only resources for selected public sources, documents and files, repositories, collections, canonical places, memorials, cemeteries, and Source classification tags. MCP never accepts a Personal API token.

Use the root .mcp.json with clients that support project or plugin MCP configuration.

Personal API and imports

Use the Personal API only for user-authorized contributions:

  • interactive reference: https://openheritage.online/api-docs;
  • OpenAPI 3 document: https://openheritage.online/api/openapi/v1.json.

Personal API tokens are bearer tokens and always include api:read. A generic catalog-only Source import uses api:sources; adding SourceDocuments, original files, page images, or PAGE XML also uses api:documents. A Source is valid without documents when no digital representation is available. The openheritage-source-import skill explains repository references, Authors, classification tags, coverage dates and places, and optional document ingestion.

A classified newspaper import additionally uses api:authors to create or update the canonical newspaper organization authority, api:sources to create issue Sources and configure the automated Collection, and api:documents to create the issue document and upload ordered page images and PAGE XML. Send the token only in the Authorization: Bearer ... header, never to MCP or in a URL.

The openheritage-newspaper-import skill contains the complete issue workflow. It resolves the environment-specific UUID for stable Source taxonomy code record-kind-newspaper, creates or reuses the newspaper organization Author, configures an Author-driven Collection grouped by publication year, records the holding repository and publication place when known, creates each issue as a publication, and uploads its ordered document pages and PAGE XML. Standalone newspaper clipping PhotoAssets remain part of openheritage-photos.

Add OpenHeritage to your agent / Додайте OpenHeritage до свого агента

English

Use the MCP connection for live, public OpenHeritage search. Add the skills as well when you want your agent to receive focused guidance for memorials, graves, archival documents, historical photos, and genealogy research.

Codex

bash
codex mcp add openheritage --url https://openheritage.online/mcpnpx skills add OpenHeritageOnline/agent-tooling

Gemini CLI

bash
gemini mcp add --scope user --transport http openheritage https://openheritage.online/mcpgemini skills install https://github.com/OpenHeritageOnline/agent-tooling

Claude Code — install the complete plugin, which includes both the MCP server and skills:

bash
claude plugin marketplace add OpenHeritageOnline/agent-toolingclaude plugin install agent-tooling@openheritage

If you only need live search in Claude Code, use this instead:

bash
claude mcp add --transport http --scope user openheritage https://openheritage.online/mcp

Start a new chat after installation. In an open Claude Code session, run /reload-plugins after installing the plugin. Do not install both the Claude plugin and its separate MCP entry unless you intentionally want duplicate configuration.

Українською

Підключіть MCP, щоб агент міг шукати публічні записи OpenHeritage у реальному часі. Додайте також навички, якщо хочете, щоб агент отримав спеціальні інструкції для роботи з меморіалами, могилами, архівними документами, історичними фотографіями та генеалогічними дослідженнями.

Codex

bash
codex mcp add openheritage --url https://openheritage.online/mcpnpx skills add OpenHeritageOnline/agent-tooling

Gemini CLI

bash
gemini mcp add --scope user --transport http openheritage https://openheritage.online/mcpgemini skills install https://github.com/OpenHeritageOnline/agent-tooling

Claude Code — встановіть повний плагін: він містить і MCP-сервер, і навички.

bash
claude plugin marketplace add OpenHeritageOnline/agent-toolingclaude plugin install agent-tooling@openheritage

Якщо в Claude Code потрібен лише пошук, використайте натомість:

bash
claude mcp add --transport http --scope user openheritage https://openheritage.online/mcp

Після встановлення почніть новий чат. Якщо ви встановили плагін у вже відкритій сесії Claude Code, виконайте /reload-plugins. Не встановлюйте одночасно плагін Claude та окремий запис MCP, якщо навмисно не хочете дублювати конфігурацію.

Claude Code

Add the public OpenHeritage marketplace, then install the complete plugin:

bash
claude plugin marketplace add OpenHeritageOnline/agent-toolingclaude plugin install agent-tooling@openheritage

Connect only the MCP server:

bash
claude mcp add --transport http --scope user openheritage https://openheritage.online/mcp

To load the complete plugin from a checkout:

bash
claude --plugin-dir /path/to/agent-tooling

The repository includes a Claude Code manifest at .claude-plugin/plugin.json.

Codex and other Agent Skills clients

Install the portable skills from GitHub with a compatible Agent Skills installer:

bash
npx skills add OpenHeritageOnline/agent-tooling

The repository also includes a Codex manifest at .codex-plugin/plugin.json. Plugin-aware hosts can load the repository checkout directly and use its bundled .mcp.json.

Every Agent Skills-compatible host can also discover the seven published skills from the OpenHeritage Agent Skills index. For an MCP host without plugin support, add the openheritage entry from .mcp.json to its user or project MCP configuration.

Skills

SkillBest for
openheritageBroad searches across all public OpenHeritage domains
openheritage-archivesSources, documents, repositories, collections, pages, files, entries, and exports
openheritage-source-importCatalog-only Sources and optional SourceDocument ingestion with repository, Author, tag, date, and place provenance
openheritage-newspaper-importComplete newspaper issue preparation, organization Authors, automated year Collections, repository and publication-place provenance, ordered page uploads, PAGE XML, verification, and repair
openheritage-photosHistorical photos, media variants, photo maps, corrections, and people on photos
openheritage-memorialsMemorials, cemeteries, cemetery photos, maps, statistics, and exports
openheritage-researchesPublic genealogy research projects, questions, hypotheses, places, and evidence

The same versioned skill documents are also published from the OpenHeritage website:

MCP Registry

server.json publishes the remote server as io.github.OpenHeritageOnline/public-search in the official MCP Registry. The GitHub Actions workflow publishes it when an mcp-v* tag is pushed:

bash
git tag mcp-v2.11.3git push origin mcp-v2.11.3

The workflow uses GitHub OIDC, so it requires no stored token or domain-verification private key. Registry versions are immutable: bump server.json before creating a later tag.

Publishing is restricted to protected release refs and the mcp-registry-production GitHub Environment. The publisher is downloaded from an exact release, verified by SHA256 and Sigstore identity, and checked for the expected version and source commit before the OIDC-capable job can run. See the required repository controls before creating a release tag.

Safety

  • Treat search results as discovery leads, not proof of identity or family relationship.
  • Respect record visibility and copyright restrictions.
  • Do not crawl, bulk-enumerate, or collect profile/contact data.
  • Prefer canonical OpenHeritage pages when sharing results with a user.
  • Use authenticated or mutating REST workflows only when the user explicitly requests them.
  • Never print, persist, or forward a Personal API token; request only the scopes needed for the authorized operation.

Source of truth

The production skill documents are maintained in the main OpenHeritage application repository under sources/FrontendServer/AgentSkills/. Keep the copies in skills/ byte-for-byte synchronized when releasing a new version.

來源：README.md，提交 c9f6ed4

工具

13

search_collections

Search public OpenHeritage collections by text.

輸入參數query必填

search_memorials

Search public memorial records by text.

輸入參數query必填

find_places_nearby

Find active canonical places near coordinates, optionally resolving historical context for a date.

輸入參數datetakelatitude必填radiusKmtypeCodelongitude必填

search_sources

Search public sources by text.

輸入參數query必填

search_records

Search public OpenHeritage records across supported entity types.

輸入參數query必填entityTypes

search_documents

Search public source documents by text.

輸入參數query必填

get_place

Read a canonical place by stable ID, optionally resolving its historical context for a date.

輸入參數dateplaceId必填

search_cemeteries

Search public cemeteries by text.

輸入參數query必填

search_authors

Search public person and organization author authority records by text.

輸入參數query必填

search_repositories

Search public source repositories by text.

輸入參數query必填

search_places

Search active canonical places by text and optional geographic or type filters.

輸入參數datequery必填latituderadiusKmtypeCodelongitudehasCoordinates

autocomplete_places

Autocomplete active canonical places by prefix, optionally resolving historical context for a date.

輸入參數datetakequery必填typeCode

search_page_text

Search the transcribed text of public document pages, by keyword and meaning; each hit links to its page.

輸入參數query必填semanticsourceIddocumentId

版本歷史

1
  1. v2.11.3最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。