Skip to main content
Glama
deenesjakoruzh
abhishektangudu

pdf-agent-toolkit-mcp

by abhishektangudu
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

PDF Agent Toolkit & MCP Server (вдохновлён ihatepdf.cv)

Комплексный набор инструментов для работы с PDF с приоритетом конфиденциальности и сервер Model Context Protocol (MCP) для ИИ-агентов (Claude Desktop, Cursor, Windsurf, LangChain, Claude Code).

Основные принципы

  1. Ноль загрузок в облако: вся обработка PDF (сжатие, изменение порядка страниц, поворот, закрашивание и извлечение текста) выполняется на 100% локально на чистом TypeScript и WebAssembly.

  2. Оптимизация токенов агента: устраняет раздувание контекста, исключая сырые дампы PDF в base64 из промптов; по запросу возвращает структурированные оглавления и фрагменты страниц.

  3. Универсальная совместимость: работает из коробки с stdio JSON-RPC 2.0.

Related MCP server: pdfeverything

🛠️ Доступные MCP-инструменты

Имя инструмента

Категория

Описание

Оптимизация для агента

compress_pdf

Оптимизация

Уменьшает размер файла за счёт дефрагментации потоков и пресетов DPI (screen, ebook, printer).

Снижает объём токенов для последующих этапов OCR и компьютерного зрения до 70%.

extract_pdf_content

Аналитика

Извлекает оглавление документа, его структуру, количество слов и чистый Markdown-текст.

Экономит ~90% токенов контекста по сравнению с дампом сырого потока данных.

scan_and_redact_pii

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

Обнаруживает SSN, email-адреса, номера кредитных карт, номера Aadhaar и пользовательские ключевые слова, закрашивая их чёрными блоками.

Обеспечивает соответствие требованиям GDPR/HIPAA перед отправкой документов внешним LLM.

organize_pdf

Структура

Составной инструмент: изменяет порядок страниц, удаляет, поворачивает (90/180/270°) и добавляет номера страниц за один атомарный проход.

Позволяет избежать многошаговых повторных обращений.

split_pdf

Структура

Извлекает заданные диапазоны страниц (например, "1-3, 5, 8-12").

Позволяет агентам просматривать отдельные главы.

merge_pdfs

Структура

Объединяет несколько входных PDF-файлов в один документ.

Быстрая сборка документа из нескольких файлов.

stamp_watermark

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

Наносит видимые текстовые водяные знаки (например, "DRAFT", "CONFIDENTIAL") с настраиваемым поворотом и непрозрачностью.

Визуальное обозначение статуса.

create_pdf_from_text

Создание

Преобразует чистый Markdown/текст в PDF формата A4 со стилизованными заголовочными баннерами.

Лёгкая генерация документов без громоздкого headless-браузера.

inspect_and_fill_form

Формы

Инспектирует поля AcroForm и заполняет данные форм.

Автоматизирует обработку счетов, налоговых документов и договоров.

🚀 Быстрый старт: конфигурации для агентов

1. Cursor IDE (.cursor/mcp.json)

{
  "mcpServers": {
    "pdf-agent-toolkit": {
      "command": "npx",
      "args": ["-y", "pdf-agent-toolkit-mcp@latest"]
    }
  }
}

2. Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "pdf-tools": {
      "command": "npx",
      "args": ["-y", "pdf-agent-toolkit-mcp"]
    }
  }
}

3. LangChain и LangGraph (Python)

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_google_genai import ChatGoogleGenerativeAI

async def main():
    async with MultiServerMCPClient({
        "pdf_tools": {
            "command": "npx",
            "args": ["-y", "pdf-agent-toolkit-mcp"],
            "transport": "stdio",
        }
    }) as client:
        tools = client.get_tools()
        model = ChatGoogleGenerativeAI(model="gemini-2.5-flash")
        agent = create_react_agent(model, tools)
        
        response = await agent.ainvoke({
            "messages": [("user", "Compress ./financials.pdf and blackout sensitive SSNs")]
        })
        print(response)

💻 Запуск сервера локально

# Run MCP server on stdio
npm run mcp

# Start the interactive visual testing studio and playground
npm run dev

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Nutrient Document Engine MCP

    PSPDFKit
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents and users to process documents through natural language, supporting PDF operations like text extraction, redaction, splitting, form filling, annotations, and content search.
    45 npm
    62
    MIT

  • pdfeverything

    Lezheng2333
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to perform 13 PDF operations (merge, split, compress, watermark, encrypt, and more) on local files via MCP.
    3
    -

  • 1pdf

    WendongAI
    A
    license
    C
    quality
    C
    maintenance
    Enables AI assistants to perform PDF operations like merge, split, compress, convert, encrypt, OCR, and summarize using natural language.
    98
    13 npm
    MIT

  • tooldash-mcp

    LassiB999
    A
    license
    A
    quality
    B
    maintenance
    Enables AI agents to inspect PDFs, merge or extract pages, and clean text entirely offline through the Model Context Protocol, with no uploads, API keys, or network calls.
    4
    36 npm
    MIT