# pdf-toolkit-mcp

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

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12 у репозитория
- Автор: AryanBV
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/AryanBV/pdf-toolkit-mcp
- Обновлён: 2026-07-22
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/pdf-toolkit-mcp

## Что делает

Сервер умеет читать и писать PDF: извлекает текст и метаданные, заполняет и сплющивает формы, собирает документы из Markdown или данных, накладывает QR-коды, шифрует AES-256, режет, склеивает и переставляет страницы. Инструмент `pdf_render_pages` превращает страницы в растр, чтобы модель с vision прочитала скан или PDF без текста. Слияние и разделение сохраняют поля AcroForm, а не выбрасывают их; при коллизии имён сервер присваивает каждому источнику свой префикс.

Движки работают на WASM и JavaScript, поэтому нативные зависимости и компилятор не нужны. Запуск — одной командой `npx` на Node 20 и выше. Работает без API-ключей и сети.

Всего 22 инструмента: шесть для чтения (`pdf_extract_text`, `pdf_get_metadata`, `pdf_get_form_fields`, `pdf_to_markdown`, `pdf_search`, `pdf_compare`), восемь для изменения (`pdf_merge`, `pdf_split`, `pdf_delete_pages`, `pdf_reorder_pages`, `pdf_rotate_pages`, `pdf_flatten`, `pdf_encrypt`, `pdf_add_page_numbers`, `pdf_embed_qr_code`) и группа для сборки новых документов.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add pdf-toolkit-mcp -- npx -y @aryanbv/pdf-toolkit-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add pdf-toolkit-mcp -- npx -y @aryanbv/pdf-toolkit-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pdf-toolkit-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@aryanbv/pdf-toolkit-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "pdf-toolkit-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@aryanbv/pdf-toolkit-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add pdf-toolkit-mcp npx -y @aryanbv/pdf-toolkit-mcp
```

## Когда брать
- прочитать отсканированный PDF без текстового слоя
- склеить несколько PDF с формами и не потерять поля
- зашифровать документ AES-256 с паролем владельца
- собрать PDF из Markdown или структурированных данных
- заполнить форму и превратить её в статичный контент

## Примеры запросов агенту
- Извлеки текст из первых десяти страниц `report.pdf`
- Склей `invoice.pdf` и `contract.pdf`, сохрани в `merged.pdf`
- Отрендери страницы 2–5 из `scan.pdf` в PNG, чтобы я прочитал, что там

## Похожие
- [pdf-tools](https://affpapa.org/nevibecode/skills/pdf-tools.md) — скилл · 186 установок
- [pdf-to-markdown](https://affpapa.org/nevibecode/skills/pdf-to-markdown.md) — скилл · 870 установок
- [oma-pdf](https://affpapa.org/nevibecode/skills/oma-pdf.md) — скилл · ★ 1472 у репозитория
- [PDF Generator API](https://affpapa.org/nevibecode/mcp/pdf-generator-api.md) — MCP-сервер · 346 установок
- [PDF Form Filler](https://affpapa.org/nevibecode/skills/pdf-form-filler.md) — скилл · 4900 установок
- [pdf](https://affpapa.org/nevibecode/skills/nous-research-pdf.md) — скилл · 283 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
