Skip to main content
Glama
deenesjakoruzh
abhishektangudu

pdf-agent-toolkit-mcp

by abhishektangudu
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

PDF Agent Toolkit & MCP Server (inspirado en ihatepdf.cv)

Una suite integral de manipulación de PDF centrada en la privacidad y un servidor de Model Context Protocol (MCP) para Agentes de IA (Claude Desktop, Cursor, Windsurf, LangChain, Claude Code).

Filosofía principal

  1. Cero cargas a la nube: Todo el procesamiento de PDF (compresión, reordenación de páginas, rotación, redacción y extracción de texto) se ejecuta 100% localmente en TypeScript puro y WebAssembly.

  2. Optimización de tokens de agente: Elimina la hinchazón de contexto al evitar volcados de PDF en base64 sin procesar en los prompts; devuelve esquemas estructurados y fragmentos de páginas bajo demanda.

  3. Compatibilidad universal: Funciona de serie con stdio JSON-RPC 2.0.

Related MCP server: pdfeverything

🛠️ Herramientas MCP disponibles

Nombre de la herramienta

Categoría

Descripción

Optimización para agentes

compress_pdf

Optimización

Reduce el tamaño del archivo mediante desfragmentación de flujo y ajustes preestablecidos de DPI (screen, ebook, printer).

Reduce el peso de tokens de OCR/visión posteriores hasta en un 70%.

extract_pdf_content

Inteligencia

Extrae el índice (TOC), el esquema, el recuento de palabras y texto Markdown limpio.

Ahorra ~90% de tokens de contexto en comparación con el volcado de flujo sin procesar.

scan_and_redact_pii

Seguridad

Detecta SSN, correos electrónicos, tarjetas de crédito, números de Aadhaar y palabras clave personalizadas, estampando cajas de redacción negras.

Garantiza el cumplimiento de GDPR/HIPAA antes de enviar documentos a LLMs externos.

organize_pdf

Estructura

Herramienta compuesta: reordena, elimina, rota (90/180/270°) y añade números de página en una sola pasada atómica.

Evita idas y vueltas de múltiples turnos.

split_pdf

Estructura

Extrae rangos de páginas específicos (p. ej. "1-3, 5, 8-12").

Permite a los agentes inspeccionar capítulos específicos.

merge_pdfs

Estructura

Combina múltiples PDF de entrada en un solo documento.

Compilación rápida de documentos de múltiples archivos.

stamp_watermark

Seguridad

Estampa marcas de agua de texto visuales (p. ej. "DRAFT", "CONFIDENTIAL") con rotación y opacidad personalizadas.

Sellado visual de estado.

create_pdf_from_text

Creación

Formatea Markdown/texto limpio en un PDF A4 con banners de encabezado estilizados.

Generación de documentos ligera sin la hinchazón de un navegador sin interfaz.

inspect_and_fill_form

Formularios

Inspecciona los campos de AcroForm y rellena los datos del formulario.

Automatiza el procesamiento de facturas, impuestos y contratos.

🚀 Configuraciones de inicio rápido para agentes

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)

💻 Ejecutando el servidor localmente

# 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