mcpbeat Sign in

PDF MCP Server

local only

PDF MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 1 901 installs a week from pypi. Last commit 17 Sep 2026.

Agentic RAG over one PDF or a whole folder: hybrid search, selective page reads, tables, OCR.

Installs per day peak 980 · avg 346 · +4% w/w
a month agotoday
1 901
Installs / week
pypi · pdf-mcp
135
Stars
0 open issues
17 Sep 2026
Last commit
0 releases in 90 days
MIT
License
Python

What the code does

We read the source, 18 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] benchmark_data/bedrock_kb/titan_within_doc_rank/spike.py:1
этот файл ставится пользователю, но в репозитории его нет
Runs an external command packaging/mcpb/server/launcher.js:105
      child = spawn(cmd, args, { ...opts, windowsHide: true });
Runs an external command src/pdf_mcp/extractor.py:190
        result = subprocess.run(
Page executes code built at runtime pages/index.html:1222, [пакет] pages/index.html:1218
      document.getElementById("clientNote").innerHTML = c.note;

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add pdf-mcp -- uvx pdf-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "pdf-mcp": {
      "args": [
        "pdf-mcp"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.pdf-mcp]
command = "uvx"
args = ["pdf-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "pdf-mcp": {
      "args": [
        "pdf-mcp"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "pdf-mcp": {
      "args": [
        "pdf-mcp"
      ],
      "command": "uvx"
    }
  }
}

This one needs environment variables set before it will start: PDF_MCP_CACHE_DIR (Directory for storing PDF cache (default: ~/.cache/pdf-mcp)), PDF_MCP_CACHE_TTL (Cache time-to-live in hours (default: 24)). The author declared them in the registry entry; get the values from the project itself.

Alternatives to PDF MCP

same job, measured the same way
Minirag MCP
by sfrangulov

Local-first RAG MCP server: hybrid search over a folder of your own documents

220 installs/wk local only
SearchForge
by divyanshu-iitian

Free open-source web search and page reading for LLMs, AI agents, and RAG.

local only
pgvector
by mittalpk

Similarity search, hybrid search, and index management for pgvector-backed PostgreSQL tables

62 installs/wk local only
I
trelix
by sairam0424

Semantic code search for AI agents — hybrid BM25+vector, call-graph, 20+ languages.

1 185 installs/wk local only
Tillpad
by cnrcode

Bounded KVP, RAG search, and wipe receipts for agent jobs over remote MCP

answering
Opensolr MCP
by opensolr

Managed Apache Solr for agents: hybrid BM25+kNN search, server-side embeddings, RAG answers

637 installs/wk local only
MCP Knowledge RAG
by infoinlet-marketplace

Permission-aware RAG for agents — ingest docs, hybrid search, cited answers (hosted API).

21 installs/wk local only
RAG Vault
by robthepcguy

Local RAG MCP server with hybrid search, PDF/DOCX support, and zero-config setup

69 installs/wk local only

PDF MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for PDF MCP?
PDF MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package pdf-mcp was installed 1 901 times last week.
How do I connect PDF MCP?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls pdf-mcp straight from pypi; nothing to host, nothing to sign up for.
How many people use PDF MCP?
The pypi package pdf-mcp was installed 1 901 times in the last week. Week over week that is +4%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is PDF MCP open source?
Yes — it is published under the MIT licence, written in Python and 135 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.