DamnPDFs Codex MCP bridge

Damn PDFs por Sourav Bera

Conecta Codex a tu espacio de trabajo de navegador aprobado de DamnPDFs. 71 herramientas de archivos para PDFs, documentos de Office, imágenes y audio, con operaciones MCP individuales, importación/exportación local de archivos y flujos de trabajo guiados.

Instalar en Codex

En Plugins → Añadir → Añadir un marketplace, introduce:

SouravBeraAkaSpeed/damnpdfs-codex-plugin

Elige Damn PDFs por Sourav Bera e instala. Los comandos CLI equivalentes son:

codex plugin marketplace add SouravBeraAkaSpeed/damnpdfs-codex-plugin --ref main
codex plugin add damnpdfs@damnpdfs

Alternativamente, descarga damnpdfs-1.0.0.zip desde Releases y usa Añadir → Subir archivo de plugin. Inicia un nuevo chat de Codex después de la instalación para que las habilidades del plugin y las herramientas MCP se carguen. Node.js 22 o posterior debe estar disponible como node.

Este es un marketplace público de Codex respaldado por Git. Añadir esta fuente hace que el plugin sea instalable; no significa que haya sido seleccionado para el directorio público/destacado predeterminado.

Primer prompt seguro

Conecta DamnPDFs a un nuevo espacio de trabajo de navegador vacío. Muestra el estado de la conexión y el número de herramientas disponibles antes de subir cualquier archivo.

Abre damnpdfs.com, selecciona Acceso de agente, crea un código y vincúlalo usando connect_browser. Con el control del navegador disponible, Codex puede leer el código desde la pestaña aprobada. No se necesita clave API, verificación de cuenta de API de OpenAI ni archivo de token persistente. Solo se acepta el código de vinculación temporal; nunca proporciones una contraseña, clave de proveedor o cookie del navegador.

Luego prueba:

• "Comprime este PDF para correo electrónico, compara los tamaños y guarda una nueva copia."
• "Convierte este PowerPoint a PDF y combínalo después de este documento."
• "Comprime estas imágenes PNG manteniendo la transparencia."
• "Inspecciona la página dos, reemplaza esta palabra y verifica el PDF descargado."

Cómo funciona

El puente stdio de Node.js sin dependencias expone 71 herramientas de tareas, ocho operaciones de espacio de trabajo y cinco ayudantes de conexión/archivos. Reenvía solicitudes autorizadas a través del mismo puente de ejecución del navegador utilizado por DamnPDFs WebMCP. El soporte nativo opcional de WebMCP no es necesario para esta ruta de vinculación HTTPS. La pestaña del navegador permanece abierta y ejecuta la tarea; esto no es un servicio de automatización en la nube sin supervisión.

Las credenciales de sesión permanecen en la memoria del proceso del puente. Una sesión dura inicialmente dos horas y puede renovarse mientras su pestaña vinculada permanezca conectada con la renovación automática habilitada. La revocación o expiración requiere volver a vincular. La retención de archivos no se extiende con la renovación de sesión.

Permisos y límites de datos

• Lectura: solo archivos del espacio de trabajo y rutas locales exactas seleccionadas o aprobadas para la tarea. No hay búsqueda en el sistema de archivos, acceso al historial de Codex, acceso a cookies ni importación de archivos de credenciales.
• Escritura: crea los archivos de salida solicitados con creación exclusiva; los archivos existentes nunca se sobrescriben con el ayudante de exportación. La limpieza del espacio de trabajo, la cancelación y la revocación están etiquetadas por separado como operaciones destructivas.
• Red: solo https://api.damnpdfs.com; las importaciones locales de archivos suben los bytes seleccionados al almacenamiento temporal en la nube. Las subidas solo desde el navegador pueden usar el sitio web directamente. Las conversiones/compresiones nativas usan los trabajadores temporales existentes en la nube. La IA externa necesita la configuración del proveedor introducida por el usuario directamente en el sitio web.
• Retención: las copias de documentos del navegador duran como máximo cuatro horas; las copias temporales en la nube duran como máximo una hora o una limpieza confirmada antes. Las descargas guardadas por el usuario permanecen bajo su control. El puente no añade análisis, credenciales en disco, visitas programadas, anuncios ni navegación en segundo plano. La medición del sitio web se describe en su política de privacidad.
• Limitaciones: se requiere una pestaña conectada, una operación se ejecuta a la vez, los originales se conservan, el texto escaneado puede necesitar OCR, las fuentes faltantes pueden afectar las conversiones de Office, y una firma visible en PDF no es una firma de certificado. Verifica las salidas y advertencias reales.

Más detalles: guía de instalación del sitio web, configuración del plugin, privacidad, términos, ayuda/contacto, guías de herramientas.

Evaluación del directorio

El Dockerfile raíz proporciona un punto de entrada stdio de Node.js 22 sin privilegios para la introspección de MCP. Contiene solo el puente público y el catálogo; no se incluyen credenciales, archivos de documentos ni código fuente del producto. Compila con docker build -t damnpdfs-mcp-test . y ejecuta node scripts/verify-container.mjs para verificar el inicio sin red, almacenamiento de solo lectura y capacidades reducidas. CI realiza esta verificación en Linux. Las tareas reales de documentos aún requieren un espacio de trabajo de navegador aprobado y conectado y acceso a la red; la verificación de la lista de herramientas de un evaluador no certifica cada operación de documentos.

Inspeccionar, probar y actualizar

No se necesita instalación de dependencias para el plugin o las pruebas:

node --test tests/*.test.mjs
node scripts/validate.mjs
node scripts/pack.mjs

catalog_check verifica la deriva del esquema público sin subir documentos. codex plugin marketplace upgrade damnpdfs actualiza la fuente; reinstala con codex plugin add damnpdfs@damnpdfs, luego usa un nuevo chat. Reporta problemas sin adjuntar documentos privados, credenciales o códigos de vinculación.

La licencia MIT cubre este paquete de plugin, no una transferencia de propiedad de documentos de usuario o del servicio alojado. Integración independiente por Sourav Bera; sin afirmación de respaldo de OpenAI.