使用说明

项目简介

Otzaria-Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务器，它专注于为大型语言模型（LLM）提供访问和搜索犹太教文本和文献的能力。通过标准化的 MCP 接口，LLM 可以利用此服务器进行高效的全文检索，并获取包含参考信息、主题和高亮片段的丰富搜索结果。

主要功能点

全文搜索: 在大量的犹太教文本和文献中执行全文检索。
高级查询语法: 支持复杂的查询，包括：
- 字段特定搜索 (例如：在文本内容、参考文献或主题中搜索)
- 布尔运算符 (AND, OR)
- 必需和排除词汇 (+term, -term)
- 短语搜索 ('exact phrase')
- 通配符 (?, *)
相关性评分: 搜索结果根据相关性进行排序。
丰富的搜索结果: 返回包含参考文献、主题和高亮显示匹配片段的结果。

安装步骤

克隆仓库

打开终端并执行以下命令来克隆仓库到本地：

git clone https://github.com/MCP-Mirror/Sivan22_mcp-otzaria-server.git
cd Sivan22_mcp-otzaria-server

下载索引

从这里下载索引文件，并解压到仓库根目录下，解压后的文件夹名为 'index'。
安装依赖

在仓库根目录下，运行以下命令安装项目依赖：
```
pip install .
```

服务器配置

要将 Otzaria-Server 集成到支持 MCP 的客户端（例如 Claude 桌面应用或 Cline），您需要配置 MCP 服务器的启动信息。以下是一个 JSON 格式的配置示例，您需要根据实际情况修改 'your/path/to/directory' 为您本地仓库的路径：

{
  "mcpServers": {
      "jewish_library": {
          "command": "uv",
          "args": [
              "--directory",
              "your/path/to/directory",
              "run",
              "jewish_library"
          ],
          "env": {
            "PYTHONIOENCODING": "utf-8"
          }
      }
  }
}

'server name': 服务器名称，这里是 'jewish_library'，客户端用此名称引用该服务器。
'command': 启动服务器的命令，这里使用 'uv' 运行 Python 脚本。
'args': 传递给 'command' 的参数列表：
- '--directory': 指定服务器的工作目录，需要设置为您的仓库路径 'your/path/to/directory'。
- 'run jewish_library': 运行 'jewish_library' 模块下的服务器程序。
'env': 环境变量设置，'PYTHONIOENCODING: utf-8' 用于确保字符编码正确。

请将 'your/path/to/directory' 替换为 Otzaria-Server 仓库在您电脑上的实际路径。然后将以上 JSON 配置添加到您的 MCP 客户端的配置文件中。

基本使用方法

配置完成后，在 MCP 客户端中，您可以使用 'full_text_search' 工具来搜索犹太教文献。例如，您可以在 Claude 的对话框中输入如下指令来调用 'full_text_search' 工具：

@jewish_library/full_text_search?query=祷告的意义

或者更复杂的查询，例如搜索关于安息日（Shabbat）和蜡烛（candles）的文献：

@jewish_library/full_text_search?query=+shabbat +candles

您可以在查询中使用高级语法，例如字段搜索、布尔运算符、短语搜索和通配符，具体语法规则请参考仓库 README.md 文件中 “Available tools” -> “full_text_search” 部分的详细描述。搜索结果将以文本形式返回给 LLM 客户端。

关键词

使用说明

信息