velyan/pdf-card-mcp

velyan/pdf-card-mcp

от velyan
PDF Card MCP — локальный MCP сервер и инструмент, который превращает плотные PDF в портативные HTML-читалки с привязкой к страницам. Сохраняет текст, обрезает таблицы, фигуры и формулы, извлекает стили из PDF. Идеален для чтения, цитирования и заметок — всё работает офлайн без облачных сервисов.

PDF Card MCP

CI Source Install Python 3.11-3.13 License: MIT MCP Registry

PDF Card MCP is a local-first MCP server and CLI for turning dense local PDFs into portable, source-linked HTML readers. An MCP host can ask it to convert a PDF path, validate notes/highlights, or publish a static annotated reader bundle. The converter preserves source text, renders source pages for verification, crops detected tables, figures, and display formulas as images, derives safe reader styling from the original PDF palette, and writes a standalone HTML file that can be moved across devices without losing assets.

Default conversion runs locally and does not require a hosted service. Optional MCP sampling is deliberately bounded: the host model may choose validated style tokens or suggest card-boundary polish operations, but raw CSS and source-text rewrites are rejected.

The default reader is designed for comfortable reading: large type, small cards, search, section navigation, next/previous controls, keyboard navigation, a font-size slider, and source-page previews.

PDF Card MCP is meant for PDFs you actually need to read, cite, or inspect. It turns long documents into smaller source-linked cards, keeps tables/figures/formulas as faithful image crops, and lets you export your own notes and highlights as Markdown.

Инструменты были проиндексированы:
convert_pdf_to_card_html

Преобразует локальный PDF в портативный HTML-ридер со ссылками на исходный текст. Сгенерированный ридер — это статический HTML со встроенными ресурсами. Он сохраняет исходный текст нетронутым, включает предпросмотр исходных страниц для проверки и вырезает обнаруженные таблицы, рисунки и выводимые формулы в виде изображений. Дополнительная MCP-выборка ограничена проверенными выборами стилевых токенов или полировкой карт только по границам; сырые перезаписи CSS и исходного текста отклоняются.

Параметры
  • max_pagesinteger | null

    Необязательный лимит для очень больших PDF-файлов.

  • model_cache_dirstring | null

    Необязательный каталог кэша для весов локальной табличной ML-модели.

  • ocrboolean

    Пробует необязательный запасной вариант OCR для PDF-файлов, содержащих только изображения.

  • offlineboolean

    Используйте только уже кэшированные необязательные ML-модели.

  • output_pathstring | null

    Необязательный путь к сгенерированному HTML-файлу.

  • pdf_pathstringобязательный

    Абсолютный или относительный путь к входному PDF-файлу.

  • postprocess_engineenum

    "none" or "sampling". Sampling запрашивает у хостовой LLM только граничные операции полировки карточек, проверяет точное сохранение текста и переписывает ридер.

  • standaloneboolean

    Встраивает изображения, CSS и JavaScript в один HTML-файл.

  • style_engineenum

    «fixed», «pdf» или «sampling». Fixed сохраняет исходную мягкую палитру читателя. PDF выводит ограниченный стиль из локальных визуальных элементов PDF. Sampling запрашивает у хост-LLM выбор проверенных стилевых токенов из локальных подсказок стиля PDF.

  • table_enginestring

    «"auto", "pdfplumber" или "gmft". Auto использует gmft, если тот установлен.

  • text_enginestring

    "char_geometry" или "pdfplumber_words". По умолчанию используется геометрический интервал.

  • themestring

    Название темы Reader. Стандартная мягкая тема спокойная и минималистичная.

  • titlestring | null

    Необязательное переопределение заголовка читателя.

publish_reader_bundle

Публикует статический пакет для чтения с выбранными заметками и выделениями.

Параметры
  • annotations_pathstring | null

    Необязательный путь к sidecar-файлу аннотаций в формате JSON.

  • include_privateboolean

    Включает приватные аннотации и делает их публичными. По умолчанию: false.

  • output_pathstringобязательный

    Выводит путь к .html-файлу или каталог для статического бандла.

  • reader_html_pathstringобязательный

    Путь к автономному ридеру, сгенерированному этим инструментом.

  • read_onlyboolean

    Отключает локальное редактирование аннотаций в опубликованном ридере. По умолчанию - true.

  • redact_source_pathboolean

    Редактирует локальный путь source_pdf в опубликованной нагрузке. По умолчанию равно true.

validate_reader_annotations

Валидировать sidecar-файл с заметками и выделениями на соответствие сгенерированному reader HTML-файлу.

Параметры
  • annotations_pathstringобязательный

    Путь к sidecar-файлу JSON с аннотациями pdf-card.

  • include_privateboolean

    Проверяет также приватные аннотации. По умолчанию: true.

  • reader_html_pathstringобязательный

    Путь к автономному ридеру, сгенерированному этим инструментом.

0.1.2основная
0.1.1

Выберите клиент, чтобы установить velyan/pdf-card-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "velyan-pdf-card-mcp-r8ihmpzcrp": {
      "command": "uvx",
      "args": [
        "--from",
        "pdf-card-mcp",
        "pdf-card-mcp-server"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "velyan-pdf-card-mcp-r8ihmpzcrp": {
      "command": "uvx",
      "args": [
        "--from",
        "pdf-card-mcp",
        "pdf-card-mcp-server"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "velyan-pdf-card-mcp-r8ihmpzcrp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "pdf-card-mcp",
        "pdf-card-mcp-server"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"velyan-pdf-card-mcp-r8ihmpzcrp\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"--from\",\"pdf-card-mcp\",\"pdf-card-mcp-server\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "velyan-pdf-card-mcp-r8ihmpzcrp": {
      "command": "uvx",
      "args": [
        "--from",
        "pdf-card-mcp",
        "pdf-card-mcp-server"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add velyan-pdf-card-mcp-r8ihmpzcrp -- uvx --from pdf-card-mcp pdf-card-mcp-server

Либо через JSON-конфиг:

claude mcp add-json velyan-pdf-card-mcp-r8ihmpzcrp "{\"command\":\"uvx\",\"args\":[\"--from\",\"pdf-card-mcp\",\"pdf-card-mcp-server\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add velyan-pdf-card-mcp-r8ihmpzcrp -- uvx --from pdf-card-mcp pdf-card-mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.velyan-pdf-card-mcp-r8ihmpzcrp]
command = "uvx"
args = ["--from", "pdf-card-mcp", "pdf-card-mcp-server"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите velyan/pdf-card-mcp, а в поле команды запуска — строку ниже:
uvx --from pdf-card-mcp pdf-card-mcp-server

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "velyan-pdf-card-mcp-r8ihmpzcrp": {
      "command": "uvx",
      "args": [
        "--from",
        "pdf-card-mcp",
        "pdf-card-mcp-server"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "velyan-pdf-card-mcp-r8ihmpzcrp": {
      "command": "uvx",
      "args": [
        "--from",
        "pdf-card-mcp",
        "pdf-card-mcp-server"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например velyan-pdf-card-mcp-r8ihmpzcrp.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: velyan-pdf-card-mcp-r8ihmpzcrp
    command: uvx
    args:
      - "--from"
      - "pdf-card-mcp"
      - "pdf-card-mcp-server"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "velyan-pdf-card-mcp-r8ihmpzcrp": {
      "command": "uvx",
      "args": [
        "--from",
        "pdf-card-mcp",
        "pdf-card-mcp-server"
      ]
    }
  }
}

Похожие MCP-сервера

06ketan/slideshot

06ketan/slideshot

от 06ketan

Конвертирует AI-сгенерированные HTML-карусели в PNG, WebP, PDF и PPTX. Работает как CLI, веб-приложение, MCP-сервер или REST API. Полезен для создания слайдов и презентаций из HTML. Поддерживает се...

TypeScript⭐ 2
guimatheus92/mcp-video-analyzer

guimatheus92/mcp-video-analyzer

от guimatheus92

MCP сервер для анализа видео - извлекает транскрипт, ключевые кадры, метаданные и текст с экрана (OCR) из URL и локальных файлов. Полезен разработчикам и техподдержке для разбора видео с багами, де...

TypeScript⭐ 95
MkTurner74/botverse-mcp

MkTurner74/botverse-mcp

от mkturner74

MCP-сервер и CLI для Botverse: видеотранскодирование (MP4, WebM, GIF, ProRes) и конвертация документов (Markdown, DOCX, PDF, HTML, XLSX) — без AWS и FFmpeg. Подходит для AI-агентов, CI/CD и shell-а...

JavaScript⭐ 1
bogdan01m/zapcap-mcp-server

bogdan01m/zapcap-mcp-server

от bogdan01m

MCP-сервер для ZapCap API: загружайте видео, создавайте задачи с кастомизацией субтитров, стилей и B-roll, отслеживайте прогресс. Упрощает интеграцию AI-ассистентов для автоматизации обработки видео и видеомонтажа.

Python⭐ 1
rendobar/mcp

rendobar/mcp

от rendobar

MCP сервер для облачного сервиса обработки медиа Rendobar. Позволяет AI-агентам отправлять задачи FFmpeg и субтитров, а также загружать локальные файлы — все в одном вызове. Работает локально, без браузера.

TypeScript⭐ 1
botmonster/image2svg-mcp

botmonster/image2svg-mcp

от botmonster

MCP-сервер для конвертации растровых изображений в SVG. Работает с PNG, JPG, WEBP, принимает base64 или URL, даёт полный контроль над параметрами векторизации. Идеален для автоматизации дизайна и п...

Python⭐ 10
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин