National Library of Israel MCP Server 🇮🇱📖🔍

イスラエル国立図書館 MCP サーバー 🇮🇱📖🔍

このパッケージは、大規模言語モデルとイスラエル国立図書館の API をつなぐ Model Context Protocol（MCP）サーバーを提供します。この MCP サーバーを使用すると、AI アシスタントは NLI のカタログを検索したり、画像を取得したり、図書館のリソースにプログラムからアクセスしたりできます。

⚠️ 重要なお知らせ：これは独立した外部の取り組みであり、イスラエル国立図書館とは提携しておらず、同館からの支持も受けていません。このプロジェクトは、公共図書館のリソースを AI から利用しやすくするため、愛好家によって開発されています。

機能

• カタログ検索：一般的な検索語、タイトル、作成者、期間など、さまざまな条件で NLI のカタログを検索できます
• IIIF 画像へのアクセス：デジタル化された資料を取得、加工し、詳細情報を確認できます
• 高度なフィルタリング：リソースの種類（写真、地図、書籍など）、オンラインでの利用可否、期間、作成者で検索を絞り込めます
• 画像加工：領域、サイズ、回転、画質の各種パラメーターに対応しています
• 大きな画像への対応：高解像度画像を効率的に取得するためのタイル画像 URL を生成できます

ツール

• search_catalog

  • 高度なフィルタリングオプションを使って NLI のカタログを検索します
  • 入力：
    • query（文字列）：検索クエリ
    • resource_type（文字列、省略可）：検索するリソースの種類（写真、書籍、手稿など）
    • start_date（文字列、省略可）：開始日（形式：YYYYMMDD）
    • end_date（文字列、省略可）：終了日（形式：YYYYMMDD）
    • creator（文字列、省略可）：検索する作成者／著者名
    • availability（文字列、省略可）：利用可能な項目の種類（online_resources、all_items など）
    • page_size（整数、省略可）：返す検索結果の件数（デフォルト：10）

• get_image_info

  • IIIF Image Information API を使って画像情報を取得します
  • 入力：
    • identifier（文字列）：画像識別子

• get_image

  • IIIF Image API を使って画像を取得します
  • 入力：
    • identifier（文字列）：画像識別子
    • region（文字列、省略可）：領域パラメーター（デフォルト："full"）
    • size（文字列、省略可）：サイズパラメーター（デフォルト："max"）
    • rotation（文字列、省略可）：回転パラメーター（デフォルト："0"）
    • quality（文字列、省略可）：画像の画質（デフォルト："default"）
    • image_format（文字列、省略可）：画像形式（デフォルト："jpg"）

• get_tiled_image_urls

  • 大きな画像をタイルとして取得するための URL を取得します
  • 入力：
    • identifier（文字列）：画像識別子
    • tile_size（整数、省略可）：各タイルのピクセル単位のサイズ（デフォルト：256）

インストール

依存関係

• Python 3.10 以降
• httpx
• mcp >= 1.2.0
• uv（推奨）

uv のインストール方法については、uv のドキュメントの手順に従ってください。

ソースからこのパッケージをインストールするには、プロジェクトに移動して次のコマンドを実行します。

uv sync

Claude Desktop との連携

この MCP サーバーを Claude Desktop で使用するには、claude_desktop_config.json ファイルに次の設定を追加します。

{
  "mcpServers": {
    "nli_mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "[PATH_TO_REPO]/nli_mcp_server/main.py"
      ]
    }
  }
}

[PATH_TO_REPO] を、チェックアウトした git リポジトリの実際のパスに置き換えてください。

開発

開発時は uv を使用してサーバーを実行します。

# Start the server in development mode
uv run mcp dev main.py

ライセンス

MIT ライセンス