PDF Analyzer MCP Server

The PDF Analyzer MCP Server gives AI agents the ability to read and analyze PDF documents, enabling document Q&A through natural conversations.

Supports multiple LLM providers: Google Gemini, Anthropic Claude, and OpenAI on their direct APIs, plus Google Vertex AI and Anthropic on Vertex AI for service-account auth. Choose your preferred provider and model during setup.

Native Install (Recommended)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/IntelligentElectron/pdf-analyzer/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/IntelligentElectron/pdf-analyzer/main/install.ps1 | iex

Why use the native installer:

• No dependencies — standalone binary, no Node.js required

• Auto-updates — checks for updates on startup

• Signed binaries — macOS binaries are notarized by Apple

Update

The server checks for updates on startup. To update manually:

pdf-analyzer --update

Related MCP server: PDF RAG MCP Server

Alternative: Install via npm

For developers who prefer npm:

npm install -g @intelligentelectron/pdf-analyzer

Or use with npx (no installation required):

npx @intelligentelectron/pdf-analyzer --help

Requires Node.js 20+.

To update:

npm update -g @intelligentelectron/pdf-analyzer

Setup

After installing, run the interactive setup to choose your provider, model, and enter your API key:

pdf-analyzer --setup

You'll be prompted to choose from:

Claude Opus 4.6 is offered alongside 4.7 as the previous flagship. The Vertex AI providers offer the same Gemini and Claude models, and authenticate with a service account JSON key file instead of an API key.

You can re-run --setup at any time to switch providers or models.

Connect the MCP with your favorite AI tool

After setup, connect the MCP to your AI agent of choice.

Claude Code

Install Claude Code, then run:

claude mcp add --scope user pdf-analyzer -- pdf-analyzer

OpenAI Codex

Install OpenAI Codex, then run:

codex mcp add pdf-analyzer -- pdf-analyzer

Usage

Once connected, ask your AI assistant to analyze any PDF:

• "Analyze /path/to/document.pdf and summarize the key points"

• "What tables are in this PDF? Extract the data from table 2"

• "Compare the findings in sections 3 and 5 of this report"

The server accepts:

• Local file paths: /Users/name/docs/report.pdf

• URLs: https://example.com/document.pdf

Supported Platforms

Running as a hosted server

Setting PORT starts the server over Streamable HTTP instead of stdio, serving MCP at /mcp, a direct POST /analyze REST endpoint, and GET /health.

See deploy/README.md for deploying it to Cloud Run, including the provider and auth matrix, the IAM roles each provider needs, and how to reach the private service.

Documentation

See docs/architecture.md for how the server is put together.

See CONTRIBUTING.md for development guidelines.

About

Created by Valentino Zegna

This project is hosted on GitHub under the IntelligentElectron organization.

License

Apache License 2.0 - see LICENSE