PDF Search

Locally indexes and searches PDFs for MCP-enabled tools without external APIs.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "russellbrenner-pdfsearch-mcp": {
      "command": "node",
      "args": [
        "dist/src/server.js"
      ]
    }
  }
}

You can index and search PDFs locally with a minimal MCP server that runs inside your environment. It builds a local searchable index from a PDF (defaulting to AGLC4) and exposes search results to tools that speak the MCP protocol over stdio. This makes it easy to power LLM tooling with precise, local document content without relying on external APIs.

How to use

You run the MCP server as a local process and connect your client or tool via stdio. The server exposes an input/output interface that accepts search queries and returns text snippets with context. Use the included example configurations to wire the server into Claude Desktop, Claude Code, Codex, or any MCP-enabled client.

How to install

Prerequisites you need before installing:

Node.js and npm installed on your system
Docker if you prefer containerized usage

# Quick Node installation flow
# 1) Place the PDF here
# data/AGLC4.pdf should exist
# 2) Install dependencies
npm install
# 3) Build the index
npm run index
# 4) Run the server (stdio)
npm run dev
# or (compiled)
npm start

Additional setup and configuration

You can run the server directly or inside Docker. The server communicates over stdio, so your MCP client should launch the server process and speak MCP messages.

# Example MCP server wiring for Claude Desktop
{
  "mcpServers": {
    "aglc4": {
      "command": "node",
      "args": ["dist/src/server.js"],
      "env": {}
    }
  }
}

Docker example

# Run the server in Docker, mounting the data directory
docker build -t pdfsearch-mcp .
mkdir -p data && cp path/to/AGLC4.pdf data/AGLC4.pdf
docker run -i --rm -v "$PWD/data:/app/data" pdfsearch-mcp

Available tools

searchpdf-mcp

Provides an MCP tool interface to search the locally indexed PDF. Input includes query text and optional context controls; output returns text snippets with scores and surrounding context.