Sefaria Jewish Library MCP服务器使用说明

项目简介

Sefaria Jewish Library MCP服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 提供访问 Sefaria 犹太图书馆资源的标准化接口。通过此服务器，LLM 可以检索犹太文本、获取文本注释，从而扩展 LLM 在犹太文化和宗教文本领域的知识和服务能力。

主要功能点

检索犹太文本: 通过文本引用 (reference) 精确获取 Sefaria 图书馆中的犹太文本内容。支持英文和希伯来文引用，例如 "Genesis 1:1" 或 "שמות פרק ב פסוק ג"。
检索文本注释: 获取指定犹太文本的注释列表，方便 LLM 进一步探索和理解文本的不同解读。

安装步骤

环境准备: 确保已安装 Python 3.10 或更高版本。

克隆仓库: 使用 Git 克隆代码仓库到本地：

git clone https://github.com/OpenTorah-ai/mcp-sefaria-server.git
cd mcp-sefaria-server

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用。以下是配置 Sefaria Jewish Library MCP 服务器的 JSON 格式配置信息，适用于支持 MCP 协议的客户端，例如 Claude Desktop 或 Cline。您需要将此配置添加到您的 MCP 客户端的配置文件中。

{
  "mcpServers": {
      "sefaria_jewish_library": {
          "command": "uv",
          "args": [
              "--directory",
              "/path/to/mcp-sefaria-server",  //  请替换为您的 'mcp-sefaria-server' 仓库的实际路径
              "run",
              "sefaria_jewish_library"
          ],
          "env": {
            "PYTHONIOENCODING": "utf-8"
          }
      }
  }
}

配置参数说明:

'"sefaria_jewish_library"': 服务器名称，用于在客户端中标识和引用此服务器。
'"command": "uv"': 运行服务器的命令。这里 'uv' 是一个 Python 包管理器和运行器，如果您的环境中没有安装 'uv'，请先安装 'uv' (可以使用 'pip install uv') 或者将其替换为您熟悉的 Python 运行命令，例如 'python3' 或 'python'，并相应调整 'args' 中的参数。
'"args"': 传递给 'command' 的参数列表。
- '"--directory", "/path/to/mcp-sefaria-server"': 指定服务器代码所在的目录。请务必将 '"/path/to/mcp-sefaria-server"' 替换为您本地 'mcp-sefaria-server' 仓库的绝对路径。
- '"run", "sefaria_jewish_library"': 指示 'uv' 运行 'sefaria_jewish_library' 模块，该模块是服务器的入口点。
'"env"': 设置运行服务器所需的环境变量。
- '"PYTHONIOENCODING": "utf-8"': 设置 Python 的 I/O 编码为 UTF-8，确保正确处理希伯来文等非 ASCII 字符。

注意: 请根据您的实际环境和 Python 包管理工具调整 'command' 和 'args' 配置。确保 MCP 客户端能够正确执行配置的命令并连接到 MCP 服务器。

基本使用方法

配置完成后，在您的 MCP 客户端中选择 "sefaria_jewish_library" 服务器。您可以使用以下工具与服务器交互：

get_text: 检索犹太文本。需要提供 'reference' 参数，例如：

{
  "tool_call": {
    "name": "get_text",
    "arguments": {
      "reference": "Genesis 1:1"
    }
  }
}

服务器将返回 "Genesis 1:1" 的希伯来文文本内容。

get_commentaries: 检索文本注释列表。需要提供 'reference' 参数，例如：

{
  "tool_call": {
    "name": "get_commentaries",
    "arguments": {
      "reference": "Exodus 2:3"
    }
  }
}

服务器将返回 Exodus 2:3 的注释引用列表。

LLM 可以通过调用这些工具，并解析服务器返回的 JSON 响应，获取所需的犹太文本信息，从而进行更深入的知识探索和应用开发。

关键词