Sivan22 MCP Otzaria Server

🚀 Jewish Library MCP Server

This is an MCP (Model Context Protocol) server with powerful search capabilities, dedicated to Jewish texts and literature. It enables large language models to search for and reference Jewish texts through a standardized interface.

🚀 Quick Start

The Jewish Library MCP Server offers a standardized interface for large language models to search and reference Jewish texts.

✨ Features

• Conduct full-text searches on Jewish texts and literature.
• Support advanced query syntax:
  • Field-specific searches (text:term, reference:term, topics:term).
  • Boolean operators (AND, OR).
  • Mandatory/excluded terms (+term, -term).
  • Phrase searches ('exact phrase').
  • Wildcards (?, *).
• Provide relevance scoring.
• Offer comprehensive search results, including references, topics, and highlighted excerpts.

📦 Installation

Requires Python 3.10 or higher.

Clone the Repository

# Clone the repository
git clone https://github.com/sivan22/mcp-otzaria-server.git
cd mcp-otzaria-server

Obtain the Index

Download and extract the index from here.

Install Dependencies

pip install .

💻 Usage Examples

Basic Usage

You can run the server directly:

uv --directory your_path/to/directory run jewish_library

Advanced Usage

Or run it through a client that supports the MCP protocol. For the Claude desktop application and command-line tools, use the following configuration:

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

Available Tools

The only tool provided through the MCP interface:

full_text_search

Perform full-text searches in the Jewish library with advanced query capabilities.

Example query formats:

# Basic search
"maimonides on prayer"

# Field-specific search
text:"love your neighbor" AND topics:mitzvot

# Mandatory terms
+shabbat +candles

# Phrase search and topic filtering
"four species" AND topics:sukkot

# Wildcard search
pray* AND reference:psalms

Search results include:

• Reference information.
• Related topics.
• Highlighted excerpts showing query matches.
• Relevance scores.

🔧 Technical Details

This project uses:

• MCP SDK to implement the server.
• Tantivy to provide full-text search functionality.

Requirements

• Python >= 3.10
• MCP SDK >= 1.1.1
• Tantivy search engine

📄 License

MIT License