PDF Reader

Configuración cero en una línea

npx -y @sylphx/citra

Sin Docker. Sin clave de API. Sin instalación global. Lanza un servidor MCP stdio que los agentes pueden usar de inmediato.

Por qué Citra se siente injustamente bueno

Las herramientas de PDF en texto plano hacen que los agentes adivinen. Citra devuelve un Gemelo de Documento de Agente que pueden citar.

Cinco razones por las que los equipos eligen Citra

1. Configuración cero — MCP real de npx, no un arranque de 20 pasos.
2. Evidencia, no vibraciones — citas que los agentes pueden mostrar a un humano.
3. Local-primero — los PDFs permanecen en la máquina; sin API de visión en la nube requerida.
4. Marca única — un paquete, un binario, una historia (@sylphx/citra / citra).
5. Familia de instrumentos — compón con Iris (imagen), Cue (video), Spine, Lookout, Locus.

Ve la diferencia

Lo que obtienes

Tres herramientas. Una superficie de producto.

Llamada mínima:

{
  "sources": [{ "path": "/absolute/path/to/report.pdf" }]
}

Casos de uso principales

1. Informes financieros — extrae celdas de tabla que los agentes pueden citar por página y geometría
2. Artículos de investigación — encabezados, orden de lectura, citas a nivel de página
3. Documentos escaneados — ruta OCR con evidencia, no una sopa de texto

Plataformas

Un paquete nativo opcional se selecciona solo para tu host:

Nativo faltante → cierre seguro (sin motor PDF TypeScript silencioso).

Documentación del producto

Superficies (MCP · CLI · SDK)

MCP (ruta de agente predeterminada)

npx -y @sylphx/citra

Claude Desktop / Cursor / VS Code / Codex

{
  "mcpServers": {
    "citra": {
      "command": "npx",
      "args": ["-y", "@sylphx/citra"]
    }
  }
}

Los hosts de doble era que envían server/discover antes de initialize (p. ej. Gemini Antigravity CLI) son compatibles en stdio.

CLI

npx -y @sylphx/citra --help

SDK

• @sylphx/citra/sdk → Citra (read / search / evidence)
• @sylphx/citra/pure-rust → helpers de cliente de bajo nivel
• Mismas herramientas que MCP: read_pdf · search_pdf · pdf_evidence
• Requiere el paquete nativo opcional de la plataforma (igual que MCP)

Huella de instalación (honesta)

Compara instalaciones limpias completas, no “tarball de envoltorio JS vs ejecutable nativo”:

El binario nativo ocupa varios megabytes porque es el motor PDF. Eso es esperado — y sigue siendo una instalación más limpia que distribuir PDF.js + un árbol JS grande.

Detalles: comparación de huella de instalación

Rendimiento (acotado por método)

A/B de doble modo mismo-host linux-x64 controlado vs @sylphx/pdf-reader-mcp@3.0.14 histórico, usando nativos sole-Rust instalados desde el registro (medido en el linaje 4.1.x; el método aplica a los paquetes sole-Rust actuales):

persistent_warm incluye una caché local al proceso para path+opciones locales idénticos. La primera solicitud en un proceso aún paga el costo completo de análisis.

No es una garantía multi-host. Detalles: informe 4.1.0 · política de afirmaciones

Nota del motor

La producción actual es un motor Rust nativo en plataformas compatibles a través de un lanzador Node delgado.

Local-primero. Cinco paquetes de plataforma. Una instalación limpia. Cierre seguro sin el nativo correspondiente.

Los CMaps ToUnicode con formato inusual o rotos se manejan sin fallar; el binario de release es panic-unwind, por lo que un pánico en un hilo de trabajo falla la solicitud en lugar de abortar el proceso (#608).

Historial de ingeniería y pines de recuperación: docs/migration.md — no es el discurso del producto.

Prueba del producto y enlaces

• Sitio web / guía
• Prueba del producto
• Benchmark
• Instalación
• npm

npx -y @sylphx/citra