Georgia Archives

@pipeworx/georgia-archives

格鲁吉亚国家档案馆的三个公共目录——科学参考图书馆（Koha）、国家档案全宗登记册，以及格鲁吉亚国家电影目录。

属于 Pipeworx 的一部分——一个连接 AI Agent 与 1879+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未经其认可，也未由其发布。

工具

• archives_library_search(query, index?, offset?) — 按关键词／标题／作者／主题搜索参考图书馆。返回真实总数（而非页数）以及 20 条记录，每条都带有永久 biblionumber 和目录 URL。
• archives_library_record(biblionumber) — 返回一条经过解析的 MARC 记录：完整的字段／子字段结构，以及扁平化摘要（标题、作者、出版信息、ISBN、语言、主题）。
• archives_fonds_browse(page?) — 浏览档案全宗登记册：约 14,650 个全宗，分为 586 页，每页 25 条。每行都包含馆藏所属的地区档案馆、全宗编号、全宗名称、其曾用名称及对应的日期范围，以及行政和人事记录的起止日期。
• archives_film_search(name?, page?, locale?) — 电影目录中的 652 部新闻短片、纪录片和故事片；导演和摄影师以 {id, name} 对象表示，包含目录自身的人员 ID。

认证

无需密钥。所有端点都无需凭证即可响应。

数据源

• https://library.archives.gov.ge/cgi-bin/koha/opac-search.pl?idx=kw&q=…&format=rss2 — Koha OpenSearch RSS。<opensearch:totalResults> 返回准确总数，且支持 &offset=N，因此分页有真正的游标。
• https://library.archives.gov.ge/api/v1/public/biblios/{id} — Koha 公共 REST 接口。 /api/v1/ 本身提供无密钥的 Swagger 2.0 规范，共 129 个路径，其中 13 个为公共路径。
• https://archival-services.gov.ge/fonds/?page=N — 档案全宗登记册。
• https://kinokatalogi.archive.gov.ge/{ka|en}/records?name=… — 电影目录，这是一个请求 JSON 时会返回 JSON 的 Inertia/Laravel 应用。

接下来的人原本可能要费一番功夫才会发现的事项

**Koha 的 biblio 路由会因 Accept: application/json 而返回 400 错误。**它要求使用 MARC 媒体类型——application/marc-in-json 或 application/marcxml+xml。如果用默认标头测试，就会把可用端点误判为失效。

档案全宗登记册 URL 末尾的斜杠至关重要。/fonds?page=2 会 301 重定向到 /fonds/ 并丢弃查询参数，因此会以 200 状态返回第 1 页。其搜索仅支持 POST，需在 _token CSRF 字段中提供令牌；通过 GET 发送相同参数名会被静默忽略——再次返回第 1 页，看起来就像正常返回了零条结果。这里完全没有 JSON 接口（main.js 搜出来的全是 jQuery 内部代码，没有任何端点）。浏览并建立索引是唯一可靠的方式；不要基于它构建搜索代理。

电影目录会忽略未知参数，而不是拒绝它们。search=、keyword= 和 title= 都会以 200 状态返回未筛选的全部 652 条记录。只有 name 能进行筛选。因此，此工具包只接受一个筛选参数，不接受其他参数——如果某个参数被接受却遭到忽略，调用者就会得到伪装成搜索结果的整个目录。

**X-Inertia-Version 是部署指纹，不是常量。**将其硬编码后，下次部署时就会收到 409 错误。currentInertiaVersion() 会在每次调用时从页面的 data-page 属性中读取该值，因此只需多发起一次请求，也不会过时。

Koha 实例未启用 OAI-PMH（/cgi-bin/koha/oai.pl?verb=Identify → 404），因此没有批量获取途径；REST 与 OpenSearch 是仅有的完整接口。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "georgia-archives": {
      "url": "https://gateway.pipeworx.io/georgia-archives/mcp"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/georgia-archives/mcp 返回上表中的工具，以及 Pipeworx 共享元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单个套件端点除了该套件自己的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明确切范围，是当天情况的权威答案。

这是有意设计的，并非意外复用。元工具可以让限定范围的连接回答此套件未涵盖的问题 — 通过 ask_pipeworx 跨整个目录路由 — 无需再添加第二个 MCP 服务。目前无法挂载不含这些工具的套件端点；如果额外的架构定义消耗的上下文比路由带来的好处更多，可以连接一次完整网关，而不是连接多个套件端点。

也可以连接完整的 Pipeworx 网关，直接列出所有套件的工具，而不只是此套件的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1879+ 个数据源。唯一的区别是直接列出的套件工具不同；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/archives_library_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"tbilisi"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/archives_library_search。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行 — 无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "georgia-archives": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-georgia-archives"]
    }
  }
}

也可以直接运行它，确认服务已启动：

npx -y @pipeworx/mcp-georgia-archives

它通过 stdin/stdout 使用 MCP 通信，并仅对此套件的工具响应 initialize/tools/list/tools/call — 不包含上述网关连接额外提供的任何共享元工具。使用相同的源代码和工具，但不提供 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用自然语言提问，而不是直接调用工具 — 这在上面的套件端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Georgia Archives data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT