Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • sanderkooger-mcp-server-ragdocs
  • RAG Documentation MCP Server
  • doc-lib-mcp
  • mcp-server-asana
  • Sanity MCP Server
Back to MCP Servers
PDF RAG MCP Server

PDF RAG MCP Server

Public
hyson666/pdf-rag-mcp-server

Leverages PDF processing, vector storage, and Model Context Protocol to enable semantic search, real-time document processing, and seamless integration with AI tools via a modern web interface and MCP protocol support.

python
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with PDF RAG MCP Server

MCP Server

Unlock the full potential of PDF RAG MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

PDF RAG MCP Server

A powerful document knowledge base system that leverages PDF processing, vector storage, and MCP (Model Context Protocol) to provide semantic search capabilities for PDF documents. This system allows you to upload, process, and query PDF documents through a modern web interface or via the MCP protocol for integration with AI tools like Cursor.

Features

  • PDF Document Upload & Processing: Upload PDFs and automatically extract, chunk, and vectorize content
  • Real-time Processing Status: WebSocket-based real-time status updates during document processing
  • Semantic Search: Vector-based semantic search across all processed documents
  • MCP Protocol Support: Integrate with AI tools like Cursor using the Model Context Protocol
  • Modern Web Interface: React/Chakra UI frontend for document management and querying
  • Fast Dependency Management: Uses uv for efficient Python dependency management

System Architecture

The system consists of:

  • FastAPI Backend: Handles API requests, PDF processing, and vector storage
  • React Frontend: Provides a user-friendly interface for managing documents
  • Vector Database: Stores embeddings for semantic search
  • WebSocket Server: Provides real-time updates on document processing
  • MCP Server: Exposes knowledge base to MCP-compatible clients

Quick Start

Prerequisites

  • Python 3.8 or later
  • uv - Fast Python package installer and resolver
  • Git
  • Cursor (optional, for MCP integration)

Quick Installation and Startup with uv and run.py

  1. Clone the repository:

    git clone https://github.com/yourusername/PdfRagMcpServer.git cd PdfRagMcpServer
  2. Install uv if you don't have it already:

    curl -sS https://astral.sh/uv/install.sh | bash
  3. Install dependencies using uv:

    uv init . uv venv source .venv/bin/activate uv pip install -r backend/requirements.txt
  4. Start the application with the convenient script:

    uv run run.py
  5. Access the web interface at http://localhost:8000

  6. Using with Cursor

Go Settings -> Cursor Settings -> MCP -> Add new global MCP server, paste below into your Cursor ~/.cursor/mcp.json file. See Cursor MCP docs for more info.

{ "mcpServers": { "pdf-rag": { "url": "http://localhost:7800/mcp" } } }

You could also change localhost into the host ip you deployed the service. After this confige added to the mcp json, you will see the mcp server showes at the Cursor mcp config page, switch it on to enable the server:

Building the Frontend (For Developers)

If you need to rebuild the frontend, you have two options:

Option 1: Using the provided script (recommended)

# Make the script executable if needed chmod +x build_frontend.py # Run the script ./build_frontend.py

This script will automatically:

  • Install frontend dependencies
  • Build the frontend
  • Copy the build output to the backend's static directory

Option 2: Manual build process

# Navigate to frontend directory cd frontend # Install dependencies npm install # Build the frontend npm run build # Create static directory if it doesn't exist mkdir -p ../backend/static # Copy build files cp -r dist/* ../backend/static/

After building the frontend, you can start the application using the run.py script.

Simple Production Setup

For a production environment where the static files have already been built:

  1. Place your pre-built frontend in the backend/static directory
  2. Start the server:
    cd backend uv pip install -r requirements.txt python -m app.main

Development Setup (Separate Services)

If you want to run the services separately for development:

Backend

  1. Navigate to the backend directory:

    cd backend
  2. Install the dependencies with uv:

    uv pip install -r requirements.txt
  3. Run the backend server:

    python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

Frontend

  1. Navigate to the frontend directory:

    cd frontend
  2. Install the dependencies:

    npm install
  3. Run the development server:

    npm run dev

Usage

Uploading Documents

  1. Access the web interface at http://localhost:8000
  2. Click on "Upload New PDF" and select a PDF file
  3. The system will process the file, showing progress in real-time
  4. Once processed, the document will be available for searching

Searching Documents

  1. Use the search functionality in the web interface
  2. Or integrate with Cursor using the MCP protocol

MCP Integration with Cursor

  1. Open Cursor
  2. Go to Settings → AI & MCP
  3. Add Custom MCP Server with URL: http://localhost:8000/mcp/v1
  4. Save the settings
  5. Now you can query your PDF knowledge base directly from Cursor

Troubleshooting

Connection Issues

  • Verify that port 8000 is not in use by other applications
  • Check that the WebSocket connection is working properly
  • Ensure your browser supports WebSockets

Processing Issues

  • Check if your PDF contains extractable text (some scanned PDFs may not)
  • Ensure the system has sufficient resources (memory and CPU)
  • Check the backend logs for detailed error messages

Project Structure

PdfRagMcpServer/
├── backend/               # FastAPI backend
│   ├── app/
│   │   ├── __init__.py
│   │   ├── main.py        # Main FastAPI application
│   │   ├── database.py    # Database models
│   │   ├── pdf_processor.py # PDF processing logic
│   │   ├── vector_store.py # Vector database interface
│   │   └── websocket.py   # WebSocket handling
│   ├── static/            # Static files for the web interface
│   └── requirements.txt   # Backend dependencies
├── frontend/              # React frontend
│   ├── public/
│   ├── src/
│   │   ├── components/    # UI components
│   │   ├── context/       # React context
│   │   ├── pages/         # Page components
│   │   └── App.jsx        # Main application component
│   ├── package.json       # Frontend dependencies
│   └── vite.config.js     # Vite configuration
├── uploads/               # PDF file storage
└── README.md              # This documentation

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • sanderkooger-mcp-server-ragdocs
    sanderkooger-mcp-server-ragdocs

    Provides vector-based semantic search and real-time context augmentation for AI assistants by retrie...

    Added May 30, 2025
  • RAG Documentation MCP Server
    RAG Documentation MCP Server

    Provides tools for retrieving, managing, and processing documentation via vector search to enhance A...

    Added May 30, 2025
  • doc-lib-mcp
    doc-lib-mcp

    Model Context Protocol server enabling document ingestion, chunking, semantic search, and advanced n...

    Added May 30, 2025
  • mcp-server-asana
    mcp-server-asana

    Enables seamless interaction with Asana API via Model Context Protocol, providing advanced task, pro...

    22 tools
    Added May 30, 2025
  • Sanity MCP Server
    Sanity MCP Server

    Connect Sanity projects with AI tools via the Model Context Protocol to enable natural language cont...

    Added May 30, 2025