Claude Code + pdfmcp: guía de configuración

Añade pdfmcp a Claude Code con un solo comando, o mediante .mcp.json.

Solo local. Las mismas 74 herramientas, ejecutándose en tu máquina: sin cuenta, sin clave, sin límites. Con Claude Code la configuración de esta página ejecuta pdfmcp en tu máquina; puedes reinstalar o cambiar de cliente cuando quieras intercambiando la configuración.

Qué necesitas: el paquete pdfmcp local: instálalo una vez (o deja que uvx lo descargue en el primer arranque). Sin cuenta, sin clave y sin nada que sustituir por un secreto.

Dónde va: Wherever your client keeps its MCP server list

claude mcp add pdfmcp -- uvx --from https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl pdfmcp

Pasos

Run the command above (or add the JSON below to .mcp.json in your project root).
Restart Claude Code and run /mcp to confirm pdfmcp is connected.
Try: “Use pdfmcp to merge these two PDFs” — it runs on this machine.

Project-scoped .mcp.json alternative (same local server, no key):

Configuración

{
  "mcpServers": {
    "pdfmcp": {
      "command": "uvx",
      "args": [
        "--from",
        "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl",
        "pdfmcp"
      ]
    }
  }
}

Solución de problemas

El servidor local no arranca: instala el paquete una vez con pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl y ejecuta pdfmcp en una terminal para ver el error; suele ser una descarga de paquete bloqueada, o Python anterior a 3.11.
Las herramientas no aparecen: reinicia por completo el cliente después de editar su configuración; la mayoría de los clientes solo carga los servidores MCP al arrancar.
Un motor no arranca: los motores pesados se descargan una sola vez en el primer uso; comprueba tu conexión para esa descarga y vuelve a intentarlo: después todo funciona localmente.

Pruébalo con

En tu dispositivoComprimir PDFReduce el tamaño del archivo con Ghostscript. Ajustes: ligero (calidad de impresora), medio (libro electrónico), alto (pantalla, el más pequeño).Local · MCPOCR: PDF con capacidad de búsquedaHaz que un PDF escaneado sea buscable: las páginas sin capa de texto se procesan con OCR de Tesseract y obtienen una capa de texto invisible; las páginas que ya tienen texto se mantienen y se indican como omitidas.Local · MCPPDF a Word (DOCX)Convierte un PDF en un documento de Word editable. Conversión basada en texto: los párrafos y encabezados se reconstruyen a partir de la capa de texto; el diseño exacto, las tablas y las imágenes no se conservan.

Más clientes: Claude Desktop configuración MCP · ChatGPT configuración MCP · Cursor configuración MCP · Todas las guías de configuración MCP · Guía de la API local