使用说明

项目简介

Jewish Library MCP Server 是一个基于 Model Context Protocol (MCP) 的应用后端，它专注于为大型语言模型提供强大的犹太文献搜索能力。通过这个服务器，LLM 客户端可以使用标准化的 MCP 协议接口，调用工具来检索和引用丰富的犹太文本资源。

主要功能点

犹太文献全文搜索：能够对广泛的犹太经典文本和文学作品进行全面的全文搜索。
高级查询语法支持：支持复杂的查询需求，包括：
- 字段限定搜索 (例如：在文本内容、文献引用或主题中搜索特定关键词)
- 布尔运算符 (AND, OR)
- 必需和排除词汇
- 短语精确搜索
- 通配符搜索
相关性排序：搜索结果会根据与查询的相关程度进行排序，优先展示最相关的结果。
丰富的搜索结果信息：返回的搜索结果不仅包含文本内容，还包括文献引用、相关主题以及关键词高亮片段，方便用户快速定位和理解上下文。

安装步骤

克隆仓库

git clone https://github.com/sivan22/mcp-otzaria-server.git
cd mcp-otzaria-server

获取索引文件 从这里下载索引文件，并解压到仓库根目录下的 'index' 文件夹中。请确保解压后的索引文件位于 'mcp-otzaria-server/index' 目录。
安装依赖
```
pip install .
```

服务器配置

为了让 MCP 客户端（如 Claude 桌面应用或 Cline）连接到 Jewish Library MCP Server，您需要配置客户端的 MCP 服务器设置。以下是一个 JSON 格式的配置示例，您需要将其添加到您的 MCP 客户端配置中。请务必将 'your/path/to/directory' 替换为 Jewish Library MCP Server 仓库在您本地文件系统中的实际路径。

{
  "mcpServers": {
      "jewish_library": {
          "command": "uv",
          "args": [
              "--directory",
              "your/path/to/directory",  // 替换为 Jewish Library MCP Server 仓库的实际路径
              "run",
              "jewish_library"
          ],
          "env": {
            "PYTHONIOENCODING": "utf-8"
          }
      }
  }
}

基本使用方法

配置完成后，您的 MCP 客户端将能够识别并连接到 Jewish Library MCP Server。您可以通过客户端调用名为 'full_text_search' 的工具，向服务器发送搜索请求。

'full_text_search' 工具接受以下参数：

'query' (必填): 搜索查询语句，支持高级查询语法，例如：'text:"love your neighbor" AND topics:mitzvot'。详细的查询语法规则请参考工具描述或仓库的 README 文件。
'num_results' (可选): 指定返回的最大结果数量，默认为 25。

服务器将返回搜索结果，其中包含相关的犹太文献片段、文献引用等信息。您可以利用这些信息在 LLM 应用中增强上下文理解和知识检索能力。

关键词