Turath MCP Server 📚

An MCP (Model Context Protocol) server that bridges classical Arabic/Islamic texts from turath.io with AI assistants like Claude.

✨ Features

• 🔍 Search - Full-text search across thousands of classical Arabic books
• 📖 Read Pages - Retrieve specific pages from any book
• 📋 Book Info - Get metadata, table of contents, and chapter indices
• 👤 Author Details - Biographical information about scholars and authors
• 📁 Categories - Browse books by subject (Hadith, Fiqh, Tafsir, etc.)
• ⚡ Caching - In-memory cache for faster repeated queries

🔒 How it Works & Privacy

This server uses stdio (standard input/output) for communication with Claude Desktop:

• ✅ 100% Local - The server runs entirely on your machine
• ✅ No Data Storage - Your queries are not logged or stored
• ✅ Direct Connection - Data flows directly between Claude and turath.io
• ✅ Open Source - Full transparency in how your data is handled

┌─────────────┐     stdio      ┌──────────────────┐     HTTPS     ┌────────────┐
│   Claude    │ ◄────────────► │  turath-mcp-srv  │ ◄───────────► │ turath.io  │
└─────────────┘                └──────────────────┘               └────────────┘

🛠️ Installation

# Clone or create the project
mkdir turath-mcp-server && cd turath-mcp-server

# Initialize and install dependencies
npm init -y
npm install @modelcontextprotocol/sdk turath-sdk zod
npm install -D typescript tsx @types/node

🚀 Usage with Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "turath": {
      "command": "npx",
      "args": ["-y", "tsx", "/path/to/turath-mcp-server/index.ts"],
      "cwd": "/path/to/turath-mcp-server"
    }
  }
}

🔧 Available Tools

| Tool | Description | |------|-------------| | search_library | Search for books, authors, or topics | | get_book_info | Get book metadata and table of contents | | get_author_details | Get author biography and book list | | read_page | Read content from a specific page |

📂 Available Resources

| Resource URI | Description | |--------------|-------------| | turath://categories | List of book categories with IDs |

📚 Common Category IDs

| ID | Category (Arabic) | Category (English) | |----|-------------------|-------------------| | 1 | العقيدة | Creed | | 3 | التفسير | Tafsir | | 6 | كتب السنة | Hadith Books | | 7 | شروح الحديث | Hadith Commentaries | | 16 | الفقه الشافعي | Shafi'i Fiqh | | 23 | السيرة | Seerah |

💡 Example Prompts for Claude

"ابحث في كتب الحديث عن أحاديث النية"

"Find books by Ibn Hajar al-Asqalani and get his biography"

"Read page 50 from Sahih al-Bukhari"

"What does Imam al-Nawawi say about the conditions of prayer?"

🏗️ Development

# Run the server locally
npx tsx index.ts

# The server uses stdio - it will wait for JSON-RPC input

📄 License

MIT License - Feel free to use and modify.

🙏 Acknowledgments

• turath.io for providing the amazing digital library
• turath-sdk for the API wrapper
• MCP Protocol for enabling AI tool integration