图书馆资源访问服务

以色列国家图书馆MCP服务器🇮🇱📖🔍

该软件包提供了一个模型上下文协议（MCP）服务器，用于连接大型语言模型和以色列国家图书馆的API。MCP服务器允许AI助手以编程方式搜索NLI目录、检索图像和访问库资源。

⚠️ 重要提示：这是一项独立的外部倡议 无关联 与以色列国家图书馆合作或由其认可。该项目由爱好者开发，旨在提高人工智能对公共图书馆资源的可访问性。

特性

• 目录搜索：按各种条件查询NLI目录，包括通用术语、标题、创建者、日期范围
• IIIF图像访问：检索、操作和获取有关数字化材料的详细信息
• 高级过滤：按资源类型（照片、地图、书籍等）、在线可用性、日期范围和创建者控制搜索
• 图像处理：支持不同的区域、大小、旋转和质量参数
• 大图像支持：生成平铺图像URL，以高效检索高分辨率图像

工具

• 搜索目录

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

• get_image_info

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

• 获取图像

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

• get_teled_image_urls

  • 获取用于将大图像作为磁贴检索的URL
  • 输入：
    • identifier （string）：图像标识符
    • tile_size （整数，可选）：每个图块的大小（像素）（默认值：256）

安装

依赖项

• Python 3.10或更高版本
• httpx
• mcp>=1.2.0
• 紫外线（推荐）

安装紫外线时，请按照以下说明进行操作 紫外线文件.

要从源代码安装此软件包，请导航到项目并运行：

uv sync

Claude桌面集成

要将此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许可证