Jewish Library

🚀 Jewish Library MCP Server

A powerful MCP (Model Context Protocol) server for searching and referencing Jewish texts and literature. This server enables large language models to search and refer to Jewish texts through a standardized interface.

🚀 Quick Start

The Jewish Library MCP Server is a robust tool designed to facilitate searching and referencing of Jewish texts and literature. It allows large language models to interact with these resources via a standardized interface.

✨ Features

• Full-text search: Conduct full-text searches across Jewish texts and literature.
• Advanced query syntax:
  • Field-specific search: Use text:term, reference:term, topics:term for targeted searches.
  • Boolean operators: Employ AND and OR for complex queries.
  • Required/excluded terms: Specify required terms with +term and exclude terms with -term.
  • Phrase search: Search for exact phrases using single quotes, e.g., 'exact phrase'.
  • Wildcards: Utilize ? and * for flexible matching.
• Relevance scoring: Get search results ranked by relevance.
• Comprehensive search results: Results include references, topics, and highlighted excerpts.

📦 Installation

This project requires Python 3.10 or higher.

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 here.

Install dependencies

pip install .

💻 Usage Examples

Run the server

You can run the server directly:

uv --directory path/to/directory run jewish_library

Or run it through an MCP 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" 
          }
      }
  }
}

full_text_search

Execute a full - text search with advanced search capabilities across the Jewish library.

Basic Usage

# Basic search
"maimonides on prayer"

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

# Required terms
+shabbat +candles

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

# Wildcard search
pray* AND reference:psalms

Search results include:

• Citation information
• Related topics
• Highlighted excerpts matching the query
• Relevance score

🔧 Technical Details

This project uses:

• MCP SDK for server implementation.
• Tantivy to provide full - text search functionality.

📄 License

This project is licensed under the MIT License.