dsh-read-pdf — MCP-сервер и инструмент командной строки для чтения PDF в DSH

PDF-сервер на базе Model Context Protocol: извлечение текста, китайский OCR (сканы), рендеринг страниц, поиск файлов, drag-and-drop инбокс — всё работает из коробки. Совместим с любыми MCP-клиентами: DSH, Claude Desktop, Codex, Cursor или вашим собственным приложением. Репозиторий: https://github.com/xiaoxuPekingUniversity/dsh-read-pdf

Английский · Русский

Русский

Функции

CLI-версия pdf_tools.py предоставляет те же возможности и не требует MCP-клиента.

PDF Drop-инбокс (загрузка перетаскиванием): pdf_drop_server.py — это локальный веб-сервис без зависимостей. Перетащите PDF в область в браузере — и он сохранится в локальную папку. Подходит для «скармливания материалов ИИ» без поддержки вложений со стороны хоста.

Установка

pip install -r requirements.txt

Использование

Командная строка (CLI)

python pdf_tools.py info    exam.pdf
python pdf_tools.py text    exam.pdf --pages 1-3
python pdf_tools.py ocr     scanned.pdf            # 扫描版中文识别
python pdf_tools.py render  exam.pdf --pages 1-3
python pdf_tools.py find --dir ~/Downloads "期末"

PDF Drop-инбокс (загрузка перетаскиванием)

python pdf_drop_server.py --port 8765   # 浏览器打开 http://127.0.0.1:8765

В качестве MCP-сервера

DSH (добавьте в profiles/web/cordis.patch.yml):

- insert:
    - id: mcp-pdf
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        transport: stdio
        serverName: pdf
        command: python
        args:
          - /绝对路径/mcp_pdf_server.py
        failOnStartupError: false

Как нативный плагин DSH (с переключателем на веб-странице настроек, рекомендуется)

ds-plugin/ предоставляет плагин хоста без сборки: на веб-странице настроек появляется переключатель «Чтение PDF» (запускает/останавливает инструменты в рантайме). См. ds-plugin/README.md.

Claude Desktop (claude_desktop_config.json): см. examples/claude_desktop_config.json.

Типичные сценарии

• Бросьте скан экзаменационной работы в AI-клиент с поддержкой MCP → текст распознаётся автоматически → получаете разбор/конспект;

• В связке с локальным AI-воркспейсом: AI напрямую вызывает pdf_text/pdf_ocr для чтения PDF из папки с материалами.

План развития

• Поддержка дополнительных типов файлов (docx / xlsx)

• Загрузка перетаскиванием (PDF прямо в окно чата) — требуется поддержка не-графических вложений на стороне хоста; приглашаем к сотрудничеству в этом репозитории

• Объединение / разделение PDF / пакетное преобразование в изображения

Related MCP server: MCP Server Knowledge Engine

Английский

Функции

CLI (pdf_tools.py) предоставляет те же возможности без какого-либо MCP-клиента. pdf_drop_server.py добавляет локальную веб-страницу drag-and-drop инбокса без зависимостей для подачи PDF в AI-воркспейс (не требуется поддержка вложений на стороне хоста).

Установка

pip install -r requirements.txt

Использование

CLI

python pdf_tools.py info    exam.pdf
python pdf_tools.py text    exam.pdf --pages 1-3
python pdf_tools.py ocr     scanned.pdf
python pdf_tools.py render  exam.pdf --pages 1-3
python pdf_tools.py find --dir ~/Downloads "final"

В качестве MCP-сервера — зарегистрируйте в любом клиенте с поддержкой MCP (DSH, Claude Desktop, Codex…). Примеры конфигурации: examples/.

План развития

• Поддержка дополнительных типов файлов (docx / xlsx)

• Загрузка перетаскиванием в UI чатов (требуется поддержка не-графических вложений на стороне хоста — приглашаем к сотрудничеству)

• Объединение / разделение PDF / пакетное преобразование

Лицензия

MIT