PDF·gstiebler
PDF MCP — подключение и инструкция
PDF MCP Server извлекает текст, таблицы и базовые сведения из локальных PDF-файлов через pdfplumber.
Что умеет этот сервер
PDF MCP Server извлекает текст, таблицы и базовые сведения из локальных PDF-файлов через pdfplumber.
Это небольшой сервер чтения PDF.
Сначала получи 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.
- 01
Подготовь окружение
uv/uvx либо локальный Python-проект с зависимостями. Нужен доступный путь к PDF.
- 02
Установи и настрой
Добавь uvx --from git+https://github.com/gstiebler/pdf-mcp-server.git pdf-mcp-server. Для local checkout выполни uv sync и используй запуск main.py из своего окружения.
- 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-серверов Нейролюба.