OkraPDF PDF Server

БесплатноНе проверен

This MCP server enables AI agents to view PDFs as accessible HTML with bounding-box citations, and provides tools for layout-aware parsing, schema extraction, c

автор: okrapdf

GitHub Embed

Описание

This MCP server enables AI agents to view PDFs as accessible HTML with bounding-box citations, and provides tools for layout-aware parsing, schema extraction, cross-document Q&A, and PDF rendering.

README

npm License: MIT

Give your AI agent real PDF tools over the Model Context Protocol. One command connects Claude, Cursor, ChatGPT, or any MCP host to okraPDF — turn any PDF into a bbox-cited accessible HTML twin, then parse, extract, query, and render.

This package is a thin launcher around the hosted okraPDF MCP endpoint (https://okrapdf.com/mcp). There's no server to run locally — it bridges your MCP host (over stdio) to the remote server and handles sign-in for you.

Quickstart

npx @okrapdf/pdf-mcp

view_html (PDF → accessible HTML twin) works with no account. The doc-intelligence tools prompt a one-time Clerk sign-in in your browser the first time an agent calls them.

Claude Code

claude mcp add okrapdf -- npx -y @okrapdf/pdf-mcp

Claude Desktop / Cursor

Add to your MCP config (claude_desktop_config.json or Cursor's mcp.json):

{
  "mcpServers": {
    "okrapdf": {
      "command": "npx",
      "args": ["-y", "@okrapdf/pdf-mcp"]
    }
  }
}

Hosts with native remote MCP (Claude web, ChatGPT, Cursor)

Skip this package and add the URL directly: https://okrapdf.com/mcp. The launcher above is only needed for hosts that speak stdio. Same endpoint, same sign-in.

Tools

Tool	What it does	Auth
`view_html`	Stream any public PDF as a live, bbox-cited accessible HTML twin	None
doc-intelligence — parse · extract · query · resolve · upload · execute · render · workflow	Layout-aware parse, schema extraction with page/bbox citations, cross-document Q&A, renders, and multi-step workflows	Clerk sign-in

Sign-in is identity, not a paywall — the doc-intelligence tools are free with an okraPDF account. The public view_html accessibility twin needs no account. See okrapdf.com.

Configuration

Override	How
Point at a different okraPDF endpoint	`OKRA_MCP_URL=http://localhost:8787/mcp npx @okrapdf/pdf-mcp` (or pass the URL as the first arg)
Pass flags to the underlying bridge	Anything after the command is forwarded to mcp-remote, e.g. `--transport sse-only`, `--debug`

How it works

MCP host  ──stdio──▶  @okrapdf/pdf-mcp  ──HTTPS (Streamable HTTP + OAuth)──▶  okrapdf.com/mcp

okraPDF's MCP is a hosted, remote server (Cloudflare Streamable HTTP). This launcher wraps mcp-remote so stdio-only hosts can reach it and complete the Clerk OAuth sign-in for the account-gated tools.

License

MIT © okraPDF

from github.com/okrapdf/pdf-mcp

Установить OkraPDF PDF Server в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install okrapdf-pdf-mcp-server

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add okrapdf-pdf-mcp-server -- npx -y github:okrapdf/pdf-mcp

FAQ