JinDaGe - mcp-otzaria-server MCP Details

article

README

🚀 犹太图书馆 MCP 服务器

犹太图书馆 MCP 服务器是一个具备强大搜索功能的 MCP（模型上下文协议）服务器，专为犹太文本和文学作品打造。它为大型语言模型提供了标准化接口，使其能够便捷地搜索和引用犹太文本。

🚀 快速开始

犹太图书馆 MCP 服务器为大型语言模型搜索犹太文本提供了便利。以下是使用前的准备步骤。

安装

需要 Python 3.10 或更高版本。

克隆仓库

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

获取索引

从这里下载并解压索引。

安装依赖项

pip install .

运行服务器

可以直接运行服务器：

uv --directory 您的路径/to/directory run jewish_library

或通过支持 Model Context Protocol 的 MCP 客户端运行。对于 Claude 桌面应用程序和命令行工具，应使用以下配置：

{
  "mcpServers": {        
      "jewish_library": {
          "command": "uv",
          "args": [
              "--directory",
              "您的路径/to/directory",
              "run",
              "jewish_library"
          ],
          "env": {
            "PYTHONIOENCODING": "utf-8" 
          }
      }
  }
}

✨ 主要特性

全文搜索：支持对犹太文本和文学作品进行全文搜索。
高级查询语法：
- 字段特定搜索：支持通过 text:term、reference:term、topics:term 等方式进行字段特定搜索。
- 布尔运算符：支持使用 AND、OR 等布尔运算符。
- 必须或排除的词：使用 +term 表示必须包含的词，-term 表示必须排除的词。
- 短语搜索：支持使用单引号进行短语搜索，如 'exact phrase'。
- 通配符：支持使用 ? 和 * 进行通配符搜索。
相关性评分：对搜索结果进行相关性评分。
丰富的搜索结果：搜索结果包含引用、主题和高亮摘录等信息。

💻 使用示例

基本用法

服务器通过 MCP 接口提供了 full_text_search 工具，可执行带有高级查询功能的全文搜索。以下是一些示例查询格式：

# 基本搜索
"maimonides on prayer"

# 字段特定搜索
text:"love your neighbor" AND topics:mitzvot

# 必须项
+shabbat +candles

# 短语搜索与主题过滤
"four species" AND topics:sukkot

# 通配符搜索
pray* AND reference:psalms

搜索结果包括引用信息、相关主题、高亮摘录显示查询匹配以及相关性评分。

🔧 技术细节

该项目使用了以下技术实现：

MCP SDK 进行服务器实现。
Tantivy 提供全文搜索功能。

📄 许可证

本项目采用 MIT License。

mcp-otzaria-server