Georgia Archives

@pipeworx/georgia-archives

ジョージア国立公文書館の3つの公開カタログ — 科学参考図書館（Koha）、国立基金登録簿、ジョージア国立映画カタログです。

Pipeworx の一部です。AI エージェントを1879以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携も推奨もされておらず、同プロバイダーによって公開されたものでもありません。

ツール

• archives_library_search(query, index?, offset?) — キーワード／タイトル／著者／主題で参考図書館を検索します。正確な総件数（ページ件数ではありません）と、恒久的な biblionumber およびカタログURLを含む20件のレコードを返します。
• archives_library_record(biblionumber) — 1件のレコードを解析済みMARCとして返します。全フィールド／サブフィールド構造に加え、平坦化した概要（タイトル、著者、出版事項、ISBN、言語、主題）も含みます。
• archives_fonds_browse(page?) — 基金登録簿を順に閲覧します。586ページにわたる約14,650件の基金があり、1ページあたり25件です。各行には、所蔵する地域公文書館、基金番号、基金名、使用された歴史上の名称とその期間、ならびに行政記録と人事記録の対象期間が含まれます。
• archives_film_search(name?, page?, locale?) — 映画カタログにある652件のニュース映画、ドキュメンタリー、長編映画を検索します。監督と撮影技師は、カタログ固有の人物IDを持つ {id, name} オブジェクトとして返されます。

認証

認証キーは不要です。すべてのエンドポイントは認証情報なしで応答します。

データソース

• 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です。 /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を返す、Inertia/Laravelアプリの映画カタログです。

次の担当者が苦労して再発見することになる注意点

Kohaの書誌ルートは Accept: application/json を400で拒否します。 MARCメディアタイプ（application/marc-in-json または application/marcxml+xml）が必要です。デフォルトのヘッダーでテストすると、正常に動作するエンドポイントを使えないものとして報告することになります。

基金登録簿では末尾のスラッシュが不可欠です。 /fonds?page=2 は /fonds/ に301リダイレクトされ、クエリが失われるため、200で1ページ目が返されます。検索は _token CSRFフィールドを使うPOSTのみで、同じパラメーター名をGETで送信しても黙って無視されます。その結果、再び1ページ目が返され、検索結果が0件のように見えます。ここにはJSONインターフェースが一切ありません（main.js を調べてもjQueryの内部処理だけで、エンドポイントはゼロです）。誠実に実装できるのは閲覧とインデックス作成だけです。これを検索プロキシとして構築しないでください。

映画カタログは、不明なパラメーターを拒否せず無視します。 search=、keyword=、title= はすべて、絞り込まずに652件を200で返します。絞り込みに使えるのは name だけです。そのため、このパックで受け付けるフィルターは1つだけで、それ以外は受け付けません。受け付けられても無視される引数があると、呼び出し元にカタログ全体を検索結果として渡してしまいます。

X-Inertia-Version はデプロイのフィンガープリントであり、固定値ではありません。 固定値をハードコードすると、次のデプロイ時に409が返されます。currentInertiaVersion() は呼び出しごとにページの data-page 属性から値を読み取ります。リクエストは1回余分に必要ですが、値が古くなることはありません。

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"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/georgia-archives/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall、その他ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに、およそ30個の共有ツールが一覧表示されます。接続の initialize レスポンスに正確な範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的なものであり、偶然の多重化ではありません。メタツールを使うと、このパックでは扱えない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できます。そのため、2つ目の 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