MCP Docs Reader

🚀 mcp-docs-reader (English Translation)

A lightweight MCP (Model Context Protocol) server that loads PDF files from a local folder, extracts and chunks their content, builds a semantic search index, and sends relevant paragraphs to Claude Desktop for document-based Q&A.

This project is designed to be used with Claude's MCP desktop feature.

🚀 Quick Start

✨ Features

• Load and process PDF documents from the local docs/ folder.
• Extract text and divide it into semantic chunks.
• Generate sentence embeddings using SentenceTransformer.
• Build a FAISS-based vector index for semantic search.
• Retrieve top-k relevant chunks based on user queries.
• Construct prompts (relevant paragraphs + questions) and return them to Claude.
• Use uv for minimal setup.

📦 Installation

Step 1: Install Claude Desktop (if not already installed)

• Download Claude Desktop and follow the instructions to install it.

Step 2: Download mcp-docs-reader

Option 1: Download as a ZIP file

• Click “Code” > “Download ZIP”.
• Extract the downloaded ZIP file.

Option 2: Clone the repository using Git

git clone https://github.com/AIMIZING/mcp_docs_reader.git
cd mcp_docs_reader

Step 3: Configure the UV environment

Option 1: Manual configuration

• Install uv (if not already installed):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• Create and activate a virtual environment:

uv venv
.venv\Scripts\activate

• Install dependencies:

pip install -r requirements.txt

Option 2: Automatic configuration (Windows)

• Run the included “setup.bat” file.

Step 4: Configure Claude Desktop

Open the included “weather_config.json” file and copy its contents. Then, open your existing Claude Desktop configuration file and append it to the appropriate location.

Find the location of the Claude Desktop configuration file:

• Open Claude Desktop.
• Go to Menu → File → Settings → Developer Mode → Edit Configuration.
• This will open your current “claude_desktop_config.json” file.
• Paste the copied contents in the appropriate location (e.g., in the mcp list or relevant section).

⚠️ Important Note

Before pasting, make sure to replace the path "C:\PATH\TO\mcp_docs_reader" in docReader_config.json with your actual local project path.

⚠️ Important Note

Do not overwrite the entire file—ensure you append or merge to avoid destroying the existing configuration.

Step 5: Run Claude Desktop

Start Claude Desktop. Once it's running, it will automatically detect and connect to the configured MCP tool. Now you can ask questions to Claude based on local PDF documents, for example:

“Summarize the key points in the registration document.”