PDF MCP: поиск, таблицы и сканы PDF в Claude Code, Codex и Cursor

jztan/pdf-mcp· Проверено 12.11.2026· 171на GitHub

Даёт агенту читать большие PDF по страницам: искать по документу или целой папке, вытаскивать таблицы и данные графиков, распознавать сканы и показывать страницу картинкой.

3 реализации:

Поиск по ключевым словам и смыслу, работа с папкой PDF, таблицы, графики, OCR и пометка скрытого текста; кэш в SQLite переживает перезапуск.

Как подключить

Что сделать до подключения

Python 3.11–3.14 и команда pdf-mcp: uv tool install pdf-mcp или pipx install pdf-mcp

Для сканов — Tesseract: brew install tesseract, sudo apt install tesseract-ocr или winget install -e --id UB-Mannheim.TesseractOCR

Для Claude Desktop можно без Python: скачать pdf-mcp.mcpb и перетащить в Settings → Extensions

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio pdf \
  -- pdf-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.pdf]
command = "pdf-mcp"
args = []

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "pdf": {
      "command": "pdf-mcp",
      "args": []
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "pdf": {
      "type": "stdio",
      "command": "pdf-mcp",
      "args": []
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "pdf": {
      "command": "pdf-mcp",
      "args": []
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "pdf": {
      "command": "pdf-mcp",
      "args": []
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "pdf": {
        "type": "local",
        "command": ["pdf-mcp"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "pdf": {
      "command": "pdf-mcp",
      "args": []
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "pdf": {
      "command": "pdf-mcp",
      "args": []
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

pdf_infoчитает число страниц, метаданные и оглавление

pdf_searchищет по словам и смыслу

pdf_read_pagesчитает нужные страницы

pdf_read_allчитает документ целиком

pdf_get_tocотдаёт полное оглавление

pdf_render_pagesрисует страницы в PNG

pdf_extract_chartснимает точки с графиков

pdf_corpus_warmиндексирует папку с PDF

pdf_corpus_overviewделает карточки документов папки

pdf_corpus_searchищет по всей папке

pdf_cache_statsпоказывает размер кэша

pdf_cache_clearчистит кэш

server_infoпоказывает включённые функции

5 простых инструментов на PyMuPDF для даташитов и мануалов: текст страниц в JSON, Markdown или HTML, поиск по тексту и рендер страницы в PNG.

Как подключить

Что сделать до подключения

uv с командой uvx: сервер ставится из GitHub при первом запуске

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio pdf-mcp \
  -- uvx --from git+https://github.com/I-CAN-hack/pdf-mcp.git pdf-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.pdf-mcp]
command = "uvx"
args = ["--from", "git+https://github.com/I-CAN-hack/pdf-mcp.git", "pdf-mcp"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/I-CAN-hack/pdf-mcp.git", "pdf-mcp"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "pdf-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/I-CAN-hack/pdf-mcp.git", "pdf-mcp"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/I-CAN-hack/pdf-mcp.git", "pdf-mcp"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/I-CAN-hack/pdf-mcp.git", "pdf-mcp"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "pdf-mcp": {
        "type": "local",
        "command": [
          "uvx",
          "--from",
          "git+https://github.com/I-CAN-hack/pdf-mcp.git",
          "pdf-mcp"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/I-CAN-hack/pdf-mcp.git", "pdf-mcp"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/I-CAN-hack/pdf-mcp.git", "pdf-mcp"]
    }
  }
}

Инструменты сервера

get_pdf_infoчитает метаданные PDF

get_table_of_contentsчитает оглавление с номерами страниц

get_page_textизвлекает текст диапазона страниц

get_page_imageрисует страницу в PNG

search_textищет текст по всему файлу

Правит файлы: склеивает PDF в заданном порядке и вырезает страницы; сделан под Windows и помечен автором как незаконченный.

Как подключить

Что сделать до подключения

Склонировать репозиторий, в папке выполнить uv venv, активировать окружение и uv pip install -e .

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'PDF_TOOLS_ALLOWED_DIRS=<папка с PDF>' --transport stdio mcp-pdf-tools \
  -- uv --directory '<путь к папке mcp-pdf-tools>' run pdf-tools

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-pdf-tools]
command = "uv"
args = ["--directory", "<путь к папке mcp-pdf-tools>", "run", "pdf-tools"]

[mcp_servers.mcp-pdf-tools.env]
PDF_TOOLS_ALLOWED_DIRS = "<папка с PDF>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-pdf-tools": {
      "command": "uv",
      "args": ["--directory", "<путь к папке mcp-pdf-tools>", "run", "pdf-tools"],
      "env": {
        "PDF_TOOLS_ALLOWED_DIRS": "<папка с PDF>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-pdf-tools": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "<путь к папке mcp-pdf-tools>", "run", "pdf-tools"],
      "env": {
        "PDF_TOOLS_ALLOWED_DIRS": "<папка с PDF>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-pdf-tools": {
      "command": "uv",
      "args": ["--directory", "<путь к папке mcp-pdf-tools>", "run", "pdf-tools"],
      "env": {
        "PDF_TOOLS_ALLOWED_DIRS": "<папка с PDF>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-pdf-tools": {
      "command": "uv",
      "args": ["--directory", "<путь к папке mcp-pdf-tools>", "run", "pdf-tools"],
      "env": {
        "PDF_TOOLS_ALLOWED_DIRS": "<папка с PDF>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-pdf-tools": {
        "type": "local",
        "command": [
          "uv",
          "--directory",
          "<путь к папке mcp-pdf-tools>",
          "run",
          "pdf-tools"
        ],
        "environment": {
          "PDF_TOOLS_ALLOWED_DIRS": "<папка с PDF>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-pdf-tools": {
      "command": "uv",
      "args": ["--directory", "<путь к папке mcp-pdf-tools>", "run", "pdf-tools"],
      "env": {
        "PDF_TOOLS_ALLOWED_DIRS": "<папка с PDF>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-pdf-tools": {
      "command": "uv",
      "args": ["--directory", "<путь к папке mcp-pdf-tools>", "run", "pdf-tools"],
      "env": {
        "PDF_TOOLS_ALLOWED_DIRS": "<папка с PDF>"
      }
    }
  }
}

Инструменты сервера

merge-pdfsсклеивает несколько PDF

merge-pdfs-orderedсклеивает PDF в заданном порядке

extract-pagesвырезает страницы в новый файл

search-pdfsищет PDF-файлы

find-related-pdfsнаходит связанные PDF по шаблону

Что попросить агента

«Прочитай PDF <путь к файлу>»pdf-mcp вызовет pdf_info, затем pdf_read_pages или pdf_read_all

«На каких страницах говорится о <тема>?»Агент вызовет pdf_search и вернёт абзацы с номерами страниц

«Покажи, как выглядит страница 5»pdf-mcp отрисует её через pdf_render_pages

«Распознай страницы 3–5 отсканированного PDF»Агент вызовет pdf_read_pages с OCR для этих страниц

«Склей <файл 1>, <файл 2> и <файл 3> в один PDF в этом порядке»MCP PDF Tools вызовет merge-pdfs-ordered

Для каких задач

Найти в отчёте на 200 страниц раздел о рисках и прочитать только эти страницы

Искать по целой папке PDF с указанием документа и страницы

Вытащить таблицы и точные значения векторных графиков

Распознать отсканированные страницы через Tesseract

Показать агенту страницу картинкой, чтобы сверить схему или рукописный текст

Склеить несколько PDF в один или вырезать нужные страницы

Ограничения

pdf-mcp из коробки настроен на английский: смысловой поиск по русским текстам требует многоязычной модели, OCR русского — языкового пакета Tesseract и ocr_lang

Первый запуск расширения pdf-mcp для Claude Desktop скачивает около 250 МБ и идёт несколько минут

Вариант I-CAN-hack только читает файлы: склеивать и резать PDF умеет лишь MCP PDF Tools

MCP PDF Tools: 76 звёзд, автор помечает его как незаконченный, установка только из исходников, инструкция под Windows

Если не работает

pip install pdf-mcp отказывается ставить пакет в систему

Homebrew Python и свежие Debian и Ubuntu запрещают общую установку: ставьте через uv tool install pdf-mcp, pipx или в виртуальном окружении.

На Python 3.15 ставится очень старая версия pdf-mcp

У одной зависимости ещё нет сборки под 3.15: используйте Python 3.11–3.14.

MCP PDF Tools не открывает файл из другой папки

Без PDF_TOOLS_ALLOWED_DIRS сервер видит только свою рабочую папку: перечислите нужные папки в этой переменной.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
pdf-mcp	jztan	171	локально	не нужен	13	10 ноября 2026
pdf-mcp (I-CAN-hack)	I-CAN-hack	82	локально	не нужен	5	19 октября 2026
MCP PDF Tools	hanweg	76	локально	не нужен	5	22 октября 2026

Частые вопросы

Зачем MCP-сервер, если агент сам читает PDF?

Большой документ не помещается в контекст. pdf-mcp сначала ищет по файлу и отдаёт абзацы с номерами страниц, а целиком агент читает только нужные страницы.

Справится ли сервер со сканом?

pdf-mcp распознаёт сканы через Tesseract и умеет делать это параллельно по страницам. Для русского текста поставьте языковой пакет Tesseract и передайте его код в ocr_lang у pdf_read_pages.

Можно ли искать сразу по папке документов?

Да, у pdf-mcp есть инструменты для папки: pdf_corpus_warm индексирует файлы, pdf_corpus_overview даёт карточку на каждый документ, pdf_corpus_search ищет по всем и называет документ и страницу.

Что делать со скрытым текстом и подсказками-ловушками в PDF?

pdf-mcp помечает текст, который не видит читатель, включая внедрённые инструкции: его показывает pdf_info с content_trust=True, а инструменты чтения отмечают такие страницы.

Можно ли склеить PDF через агента?

Да, через MCP PDF Tools: merge-pdfs и merge-pdfs-ordered склеивают файлы, extract-pages вырезает страницы. Существующий файл сервер перезапишет только с параметром overwrite: true.

Как подключить PDF MCP к Claude Code?

Поставьте команду: uv tool install pdf-mcp, затем выполните claude mcp add pdf-mcp -- pdf-mcp. После этого попросите агента прочитать PDF по пути к файлу.

Как подключить PDF MCP к Codex?

Для варианта I-CAN-hack: codex mcp add pdf-mcp -- uvx --from git+https://github.com/I-CAN-hack/pdf-mcp.git pdf-mcp. Для pdf-mcp откройте вкладку Codex в блоке «Как подключить».

Работает ли сервер из России?

Все три сервера работают локально на вашем компьютере и не требуют аккаунтов и ключей.

PDF MCP: поиск, таблицы и сканы PDF в Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы