README.md

metadata

title: AI Digital Library Assistant
emoji: 📚
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 5.38.0
app_file: app.py
pinned: false
license: mit
tags:
  - mcp-in-action-track-consumer
  - mcp-in-action-track-creative
  - building-mcp-track-consumer
  - MCP-1st-Birthday

The AI Digital Library Assistant is a next-generation knowledge management tool built for the MCP 1st Birthday Hackathon. It transforms your static document collection into an interactive, living library.

Unlike traditional RAG (Retrieval Augmented Generation) apps, this project leverages the Model Context Protocol (MCP) to create a modular ecosystem of tools—Ingestion, Search, and Podcast Generation—that work harmoniously to help you consume information in the way that suits you best.

graph TD
    User((👤 User))
    
    subgraph "Frontend (Gradio)"
        UI[Web Interface]
        PodcastUI[Podcast Studio]
    end
    
    subgraph "MCP Server Layer"
        MCPServer[Content Organizer MCP Server]
        
        subgraph "MCP Tools"
            IngestTool[📥 Ingestion Tool]
            SearchTool[🔍 Search Tool]
            GenTool[✨ Generative Tool]
            PodTool[🎧 Podcast Tool]
        end
    end
    
    subgraph "Service Layer"
        VecStore[(Vector Store)]
        DocStore[(Document Store)]
        LLM[LLM Service (OpenAI / Nebius AI)]
        ElevenLabs[ElevenLabs API]
        LlamaIndex[LlamaIndex Agent]
    end

    User <--> UI
    UI <--> MCPServer
    
    MCPServer --> IngestTool
    MCPServer --> SearchTool
    MCPServer --> GenTool
    MCPServer --> PodTool
    
    IngestTool --> VecStore
    IngestTool --> DocStore
    SearchTool --> VecStore
    GenTool --> LLM
    PodTool --> LlamaIndex
    PodTool --> ElevenLabs
    PodTool --> LLM

🚀 Quick Start

Check out QUICKSTART.md for detailed local setup instructions.

1. Clone & Install:

   git clone https://huggingface.co/spaces/Nihal2000/AiDigitalLibraryAssistant
   pip install -r requirements.txt
   

2. Configure: Add your OPENAI_API_KEY and ELEVENLABS_API_KEY to .env.
3. Run: python app.py

💡 How It Works

1. The MCP Core

At the heart of the application is the AiDigitalLibraryAssistant. It exposes atomic capabilities (Tools) that the frontend consumes. This means the same tools powering this UI could be connected to Claude Desktop or any other MCP client!

2. 🎧 Podcast Studio (Star Feature)

Turn your reading list into a playlist! The Podcast Studio is a flagship feature that transforms any selection of documents into an engaging, multi-speaker audio podcast.

• Intelligent Scripting: Uses LlamaIndex and OpenAI/Nebius AI to analyze your documents and generate a natural, conversational script.
• Multi-Speaker Synthesis: Leverages ElevenLabs to bring the script to life with distinct, realistic voices for each host.
• Customizable: Choose your style (Educational, Casual, Deep Dive) and duration.

🏆 Hackathon Tracks

We are submitting to:

• Building MCP: For our custom AiDigitalLibraryAssistant MCP server implementation.
• MCP in Action (Consumer/Creative): For the innovative Podcast interface that makes personal knowledge management accessible and fun.

📜 License

MIT License. Built with ❤️ for the AI community.

🙏 Acknowledgements & Sponsors

This project was built for the MCP 1st Birthday Hackathon and proudly leverages technology from:

• OpenAI: Providing the foundational intelligence for our document analysis and content generation.
• Nebius AI: Powering our high-performance inference needs.
• LlamaIndex: The backbone of our data orchestration, enabling sophisticated RAG and agentic workflows for the Podcast Studio.
• ElevenLabs: Bringing our podcasts to life with industry-leading, hyper-realistic text-to-speech.
• Hugging Face: Hosting our application on Spaces and providing the Gradio framework for our beautiful, responsive UI.
• Anthropic: For pioneering the Model Context Protocol (MCP) that makes this modular architecture possible.

🔌 Connect to Claude

Want to use these tools directly inside Claude Desktop? Check out our Client Setup Guide to connect this MCP server to your local Claude instance!