The Office Worker — office-worker-mcp

Your agent's document clerk. Genera documentos de oficina profesionales — PDF, Word, Excel y PowerPoint — desde datos + un tema corporativo, y lee PDFs (texto, tablas y formularios). Diseñado para agentes de IA (Hermes, Claude, Cursor) vía MCP, 100% local-first.

pip install office-worker-mcp          # instala librería + MCP server + CLI 'owi'

Conectalo a tu agente (ejemplo config MCP / stdio):

{ "mcpServers": { "office-worker": { "command": "office-worker-mcp" } } }

Y listo: le pedís "haceme una factura/informe/deck" en lenguaje natural y tu agente usa las tools del oficinista para producir el archivo bien diseñado.

Por qué existe (diferenciadores)

Los MCPs de documentos existentes son CRUD genéricos (47+ tools que inflan el contexto) y no cubren diseño ni PDF como entrada. El Office Worker hace lo contrario:

Las 8 tools

Uso rápido (sin agente, vía CLI o Python)

from office_worker.core import create_word, create_excel, render_pdf

create_word("acta.docx", title="Acta", subtitle="Reunión", blocks=[
    {"type":"h2","text":"Puntos"}, {"type":"p","text":"Decisión tomada"}])

create_excel("balance.xlsx", title="Balance", sheets=[{"name":"Resumen",
    "headers":["Rubro","Monto"],"rows":[["Ingresos",100],["Gastos",40]]}])

Requisitos locales

• Python ≥ 3.9 · WeasyPrint (necesita fontconfig/pango en Linux) · LibreOffice opcional.
• PPTX editable (opcional): pip install office-worker-mcp[pptx] + playwright install chromium. Sin este extra, las tools de PDF/Word/Excel funcionan igual; solo create_pptx queda deshabilitada.
• Todo corre en local; sin cloud.

Desarrollo & tests

pip install -e ".[dev]"
pytest            # test_core.py (núcleo) + test_e2e_mcp.py (MCP end-to-end, 8/8 tools)

El test E2E levanta el servidor MCP real, hace handshake y ejecuta cada tool creando/leyendo archivos válidos en disco.

Licencia

MIT — ver LICENSE. Agradecimientos en NOTICE.