OpenHeritage Public Search

OpenHeritage Agent 工具

面向 OpenHeritage 的公开跨 Agent 集成文件。OpenHeritage 是一个协作式家谱与文化遗产平台。

OpenHeritage 汇集了乌克兰规模最大的公开纪念设施、墓地和档案文献数据集。

此仓库通过三种互补方式将兼容的 AI Agent 连接到 OpenHeritage：

• 用于实时搜索公开记录的远程、匿名、只读 MCP 服务；
• 七个可移植的 Agent 技能，提供领域指导、安全的 REST 备用方案和 OpenHeritage 标准链接；
• 用于用户授权贡献的 Personal API，使用具有权限范围的 bearer token。

搜索公开数据无需 API key。

大规模乌克兰遗产数据

• 纪念设施与墓地： 查找纪念设施档案、墓地、墓园记录、墓园照片、地图位置和转录文本。
• 档案文献： 搜索典藏机构和来源，按页面或原始文件获取数字化文献，并利用 XML、转录文本、解析结果或 OCR，结合来源信息回答问题。

这些记录通过 OpenHeritage 标准页面相互关联，因此 Agent 可以从初步发现线索转到相关墓园、纪念设施、来源或文献，而不会将搜索结果视为证据。

MCP 端点

https://openheritage.online/mcp

该端点使用 MCP Streamable HTTP，并提供：

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

MCP 服务还提供匿名只读资源，涵盖部分公开来源、文献和文件、典藏机构、合集、标准地点、纪念设施、墓园以及 Source 分类标签。MCP 从不接受 Personal API token。

对于支持项目或插件 MCP 配置的客户端，请使用根目录中的 .mcp.json。

Personal API 与导入

仅将 Personal API 用于经用户授权的贡献：

• 交互式参考文档：https://openheritage.online/api-docs；
• OpenAPI 3 文档：https://openheritage.online/api/openapi/v1.json。

Personal API token 是 bearer token，始终包含 api:read。仅导入通用目录 Source 时使用 api:sources；添加 SourceDocuments、原始文件、页面图像或 PAGE XML 时，还需使用 api:documents。如果没有可用的数字化版本，则 Source 无需包含文献。openheritage-source-import 技能介绍典藏机构引用、Authors、分类标签、覆盖日期和地点，以及可选的文献导入。

分类报纸导入还需使用 api:authors 创建或更新标准报纸组织权威记录，使用 api:sources 创建期号 Source 并配置自动合集，并使用 api:documents 创建期号文献以及上传按顺序排列的页面图像和 PAGE XML。仅在 Authorization: Bearer ... 标头中发送 token，切勿发送给 MCP 或放入 URL。

openheritage-newspaper-import 技能包含完整的期号工作流。它会解析稳定 Source 分类代码 record-kind-newspaper 对应的环境专属 UUID，创建或复用报纸组织 Author，配置按出版年份分组的 Author 驱动合集，记录已知的馆藏典藏机构和出版地点，将每期创建为 publication，并上传其按顺序排列的文献页面和 PAGE XML。独立的报纸剪报 PhotoAssets 仍由 openheritage-photos 处理。

将 OpenHeritage 添加到你的 Agent / 将 OpenHeritage 添加到您的 Agent

English

使用 MCP 连接进行实时、公开的 OpenHeritage 搜索。如果希望 Agent 针对纪念碑、墓地、档案文件、历史照片和家谱研究获得专门指导，也请添加这些技能。

Codex

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

Gemini CLI

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

Claude Code — 安装完整插件，其中包含 MCP 服务和技能：

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

如果在 Claude Code 中只需要实时搜索，请改用此项：

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

安装后开始新的聊天。在已打开的 Claude Code 会话中，安装插件后运行 /reload-plugins。除非你有意要重复配置，否则不要同时安装 Claude 插件和单独的 MCP 条目。

Українською

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

Codex

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

Gemini CLI

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

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

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

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

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

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

Claude Code

添加公开的 OpenHeritage 市场，然后安装完整插件：

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

仅连接 MCP 服务：

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

若要从检出目录加载完整插件：

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

此仓库包含 Claude Code 清单，位于 .claude-plugin/plugin.json。

Codex 和其他 Agent Skills 客户端

使用兼容的 Agent Skills 安装程序从 GitHub 安装可移植技能：

npx skills add OpenHeritageOnline/agent-tooling

此仓库还包含 Codex 清单，位于 .codex-plugin/plugin.json。支持插件的宿主可以直接加载此仓库的检出目录，并使用其中捆绑的 .mcp.json。

所有兼容 Agent Skills 的宿主还可以从 OpenHeritage Agent Skills 索引发现已发布的七项技能。对于不支持插件的 MCP 宿主，请将 .mcp.json 中的 openheritage 条目添加到其用户或项目 MCP 配置中。

技能

技能	最适合
openheritage	搜索所有公开的 OpenHeritage 领域
openheritage-archives	来源、文件、存储库、馆藏、页面、文件条目、记录和导出
openheritage-source-import	仅编目的来源，以及可选的 SourceDocument 导入，并包含存储库、Author、标签、日期和地点来源信息
openheritage-newspaper-import	完整的报纸期号准备工作、组织 Author、自动生成的年份馆藏、存储库和出版地点来源信息、按顺序上传页面、PAGE XML、验证和修复
openheritage-photos	历史照片、媒体变体、照片地图、修正和照片中的人物
openheritage-memorials	纪念碑、墓园、墓园照片、地图、统计数据和导出
openheritage-researches	公开的家谱研究项目、问题、假设、地点和证据

相同的版本化技能文档也发布在 OpenHeritage 网站上：

• Agent Skills 发现索引
• OpenHeritage 总体技能

MCP 注册表

server.json 将远程服务以 io.github.OpenHeritageOnline/public-search 的名称发布到官方 MCP 注册表。推送 mcp-v* 标签时，GitHub Actions 工作流会发布该服务：

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

该工作流使用 GitHub OIDC，因此无需存储令牌或域名验证私钥。注册表版本不可变：创建后续标签前，请先更新 server.json。

发布仅限受保护的发布引用和 mcp-registry-production GitHub Environment。发布工具从指定版本下载，经 SHA256 和 Sigstore 身份验证，并检查版本和源提交是否符合预期，之后具备 OIDC 能力的作业才能运行。创建发布标签前，请参阅 必需的仓库控制项。

安全

• 将搜索结果视为发现线索，而非身份或亲属关系的证明。
• 遵守记录的可见性和版权限制。
• 不要抓取、批量枚举或收集个人资料／联系方式。
• 与用户分享结果时，优先使用 OpenHeritage 的规范页面。
• 仅在用户明确要求时，使用经过身份验证的 REST 工作流或会修改数据的 REST 工作流。
• 切勿打印、持久化或转发 Personal API 令牌；仅请求执行获授权操作所需的权限范围。

信息来源

生产环境中的技能文档维护在 OpenHeritage 主应用仓库的 sources/FrontendServer/AgentSkills/ 目录下。发布新版本时，请确保 skills/ 中的副本与其逐字节一致。