National Library of Israel MCP Server 🇮🇱📖🔍

National Library of Israel MCP 服务 🇮🇱📖🔍

此软件包提供了一个 Model Context Protocol（MCP）服务，用于连接大模型与 National Library of Israel 的 API。该 MCP 服务允许 AI 助手以编程方式搜索 NLI 目录、检索图像并访问图书馆资源。

⚠️ 重要提示：这是一个独立的外部项目，与 National Library of Israel 没有关联，也未获得其认可。本项目由爱好者开发，旨在提升 AI 对公共图书馆资源的访问能力。

功能

• 目录搜索：按各种条件查询 NLI 目录，包括一般关键词、标题、创作者和日期范围
• IIIF 图像访问：检索、处理数字化资料并获取详细信息
• 高级筛选：按资源类型（照片、地图、书籍等）、在线可用性、日期范围和创作者筛选搜索结果
• 图像处理：支持不同的区域、尺寸、旋转角度和质量参数
• 大型图像支持：生成分块图像 URL，以便高效检索高分辨率图像

工具

• search_catalog

  • 使用高级筛选选项搜索 NLI 目录
  • 输入：
    • query（string）：主要搜索关键词
    • resource_type（string，可选）：要搜索的资源类型（照片、书籍、手稿等）
    • start_date（string，可选）：开始日期，格式为 YYYYMMDD
    • end_date（string，可选）：结束日期，格式为 YYYYMMDD
    • creator（string，可选）：要搜索的创作者／作者姓名
    • availability（string，可选）：可用性类型（online_resources、all_items 等）
    • page_size（integer，可选）：要返回的结果数量（默认值：10）

• get_image_info

  • 使用 IIIF Image Information API 获取图像信息
  • 输入：
    • identifier（string）：图像标识符

• get_image

  • 使用 IIIF Image API 获取图像
  • 输入：
    • identifier（string）：图像标识符
    • region（string，可选）：区域参数（默认值："full"）
    • size（string，可选）：尺寸参数（默认值："max"）
    • rotation（string，可选）：旋转参数（默认值："0"）
    • quality（string，可选）：图像质量（默认值："default"）
    • image_format（string，可选）：图像格式（默认值："jpg"）

• get_tiled_image_urls

  • 获取以分块形式检索大型图像所需的 URL
  • 输入：
    • identifier（string）：图像标识符
    • tile_size（integer，可选）：每个分块的像素尺寸（默认值：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 许可证