Kreuzberg MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

97+ formats — PDF, DOCX, XLSX, PPTX, images, HTML, EPUB, RTF
Rust core — fast, low memory footprint vs Python alternatives
OCR built in (Tesseract/PaddleOCR) for scanned documents
Preserves structure — tables as markdown, headings, lists
Extracts metadata: author, creation date, word count, language

Живое демо

Как выглядит на практике

kreuzberg.replay ▶ готово

0/0

Установка

Выберите клиент

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

{
  "mcpServers": {
    "kreuzberg": {
      "command": "uvx",
      "args": [
        "kreuzberg-mcp"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "kreuzberg": {
      "command": "uvx",
      "args": [
        "kreuzberg-mcp"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "kreuzberg": {
      "command": "uvx",
      "args": [
        "kreuzberg-mcp"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "kreuzberg": {
      "command": "uvx",
      "args": [
        "kreuzberg-mcp"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "kreuzberg",
      "command": "uvx",
      "args": [
        "kreuzberg-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "kreuzberg": {
      "command": {
        "path": "uvx",
        "args": [
          "kreuzberg-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add kreuzberg -- uvx kreuzberg-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Kreuzberg

Extract tables from a messy PDF into clean markdown

👤 Analysts dealing with report PDFs ⏱ ~10 min beginner

Когда использовать: You have a PDF with tables that pdftotext mangles and you don't want to retype them.

Предварительные требования

MCP installed — uvx kreuzberg-mcp — or add via claude mcp add

Поток

Extract

Use kreuzberg to extract /docs/2025-annual-report.pdf. Give me the tables as markdown and the body text separately.✓ Скопировано

→ Clean markdown tables with preserved headers
Verify

For the "Revenue by Segment" table, reconcile the column totals. Flag any OCR misreads.✓ Скопировано

→ Arithmetic check with flagged cells

Итог: Markdown tables you can paste into a doc without rework.

Подводные камни

Scanned PDF — OCR mistakes 6 for 8 — Use the OCR confidence output and re-scan low-confidence cells manually

Сочетать с: filesystem

Ingest a folder of mixed-format docs for downstream indexing

👤 Engineers building RAG pipelines ⏱ ~30 min intermediate

Когда использовать: Client drops you a zip with PDFs, Word docs, PowerPoints, and you need clean text for embedding.

Предварительные требования

Filesystem MCP scoped to the folder — Launch fs MCP with the ingest dir as root

Поток

Inventory

List every file under /ingest/. For each, call kreuzberg.detect_format and report.✓ Скопировано

→ Format-per-file table
Bulk extract

For each file, extract text + metadata. Write cleaned .txt next to the original and a manifest.json with metadata.✓ Скопировано

→ All files processed; manifest contains every entry
Quality check

List every file where extraction returned <100 chars — those are likely scanned or corrupt. Re-run with OCR forced.✓ Скопировано

→ Low-content files identified and retried

Итог: A folder of cleaned text files ready for embedding, with a metadata manifest.

Подводные камни

Encrypted PDF — Kreuzberg returns an error — decrypt with qpdf or ask for the unlocked copy

Сочетать с: filesystem · memory

Комбинации

Сочетайте с другими MCP — эффект x10

kreuzberg + filesystem

Walk a folder and extract every doc in place

For each PDF under /docs, extract text and save as .md next to it.✓ Скопировано

kreuzberg + memory

Ingest extracted content into a knowledge graph

Extract /contracts/*.pdf and store key terms in memory for cross-doc querying.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
extract_text	path: str, ocr?: bool	Primary extraction call	free
extract_metadata	path: str	Just want metadata without body text	free
extract_tables	path: str	Table-focused extraction	free
detect_format	path: str	Confirm format before extraction	free

Стоимость и лимиты

Во что обходится

Квота API: Unlimited — local
Токенов на вызов: Proportional to doc size; a 20-page PDF ≈ 8k tokens of output
Деньги: Free (open source)
Совет: Use extract_metadata first on large files to avoid processing irrelevant ones

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: None for local mode

Исходящий трафик: None — all processing is local

Malformed PDFs can trigger parser edge cases — sandbox the MCP if processing untrusted uploads

Устранение неполадок

Частые ошибки и исправления

ModuleNotFoundError: tesseract

Install Tesseract system binary: brew install tesseract / apt install tesseract-ocr

Проверить: `tesseract --version`

Empty output on PDF

Likely image-only PDF — re-run with ocr=true

Проверить: Check output.metadata.has_text_layer

XLSX tables come out jumbled

Pass sheet name explicitly: tool supports sheet arg

Альтернативы

Kreuzberg в сравнении

Альтернатива	Когда использовать	Компромисс
markdownify-mcp	You want a lighter, Node-based converter without OCR	Fewer formats, no table preservation
Unstructured.io	You need enterprise PDF parsing and accept the cloud cost	Paid; cloud-hosted

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills