PDF·gstiebler

PDF MCP — подключение и инструкция

PDF MCP Server извлекает текст, таблицы и базовые сведения из локальных PDF-файлов через pdfplumber.

Файлы и документыЛокальноБез ключа

Что умеет этот сервер

01

PDF MCP Server извлекает текст, таблицы и базовые сведения из локальных PDF-файлов через pdfplumber.

02

Это небольшой сервер чтения PDF.

03

Сначала получи get_pdf_info, затем извлеки текст или таблицу нужной страницы.

Задача для знакомства

Через PDF MCP получи сведения о тестовом PDF и извлеки таблицу первой страницы. Файл не меняй.

Уточнить результат

Сравни строки, колонки и порядок чтения с визуальной страницей PDF. Отсутствующий текст скана не восстанавливается автоматически одним extract_text.

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

Выберите подходящий способ

Подключить PDF MCP

Добавь uvx --from git+https://github.com/gstiebler/pdf-mcp-server.git pdf-mcp-server. Для local checkout выполни uv sync и используй запуск main.py из своего окружения.

Что понадобится

  • uv/uvx либо локальный Python-проект с зависимостями. Нужен доступный путь к PDF.
  1. 01

    Подготовь окружение

    uv/uvx либо локальный Python-проект с зависимостями. Нужен доступный путь к PDF.

  2. 02

    Установи и настрой

    Добавь uvx --from git+https://github.com/gstiebler/pdf-mcp-server.git pdf-mcp-server. Для local checkout выполни uv sync и используй запуск main.py из своего окружения.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Пример MCP-конфигурации на основе README

{
  "mcpServers": {
    "pdf-reader": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gstiebler/pdf-mcp-server.git",
        "pdf-mcp-server"
      ]
    }
  }
}

Первый запрос — пример для чата агента

Через PDF MCP получи сведения о тестовом PDF и извлеки таблицу первой страницы. Файл не меняй.

Как проверить

Сравни строки, колонки и порядок чтения с визуальной страницей PDF. Отсутствующий текст скана не восстанавливается автоматически одним extract_text.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет PDF

PDF MCP Server извлекает текст, таблицы и базовые сведения из локальных PDF-файлов через pdfplumber.

Это небольшой сервер чтения PDF. Он не является универсальным редактором, подписанием документов или OCR сканированных страниц.

Что подготовить перед подключением

uv/uvx либо локальный Python-проект с зависимостями. Нужен доступный путь к PDF.

Как установить и подключить

Добавь uvx --from git+https://github.com/gstiebler/pdf-mcp-server.git pdf-mcp-server. Для local checkout выполни uv sync и используй запуск main.py из своего окружения.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Сначала получи get_pdf_info, затем извлеки текст или таблицу нужной страницы. page_number для таблиц начинается с 1.

Как проверить результат и решить проблемы

Сравни строки, колонки и порядок чтения с визуальной страницей PDF. Отсутствующий текст скана не восстанавливается автоматически одним extract_text.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Сложная вёрстка и объединённые ячейки требуют ручной проверки. Сервер читает локальные файлы с правами процесса.

Исходники и документация

Репозиторий: gstiebler/pdf-mcp-server. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о PDF

PDF MCP Server извлекает текст, таблицы и базовые сведения из локальных PDF-файлов через pdfplumber.
Вернуться в библиотеку