docgen-mcp-server

Servidor MCP para ler, escrever, editar e renderizar documentos — DOCX, PDF, PPTX, XLSX, CSV, ODT — além de HTML/CSS → PDF/slides/imagem, diff, busca e empacotamento.

O que faz

Dá a um agente um conjunto de ferramentas de escritório sobre arquivos locais: extrair conteúdo como Markdown, gerar documentos e planilhas, renderizar HTML/CSS em PDF (Chromium), slides PowerPoint ou imagens, e operações utilitárias (patch, diff, busca, zip).

Requisitos

• Python 3.11+.
• Chromium — necessário só para renderização a partir de HTML (render_page, render_image e write_doc em PDF). Instale uma vez com playwright install chromium. As tools de DOCX/XLSX/PPTX/leitura não precisam de navegador.

Instalação

# Executar direto, via uv:
uvx docgen-mcp-server

# Ou instalar no sistema:
uv tool install docgen-mcp-server
# (alternativa: pip install docgen-mcp-server)

# Uma vez, se for usar renderização HTML (PDF/imagem):
playwright install chromium

Configuração

Aponte o cliente MCP para o servidor. Ele roda sem nenhuma configuração obrigatória — não precisa de chave nem credencial:

{
  "mcpServers": {
    "docgen": {
      "command": "uvx",
      "args": ["docgen-mcp-server"],
      "env": {}
    }
  }
}

O mesmo bloco vale para Cursor, Claude Desktop, Claude Code e outras IDEs com MCP por stdio.

Variáveis de ambiente (todas opcionais)

Segurança

• Path traversal bloqueado (rejeita ..) e limite de 50 MB por arquivo lido.
• Allowlist opcional de raízes via DOCGEN_ALLOWED_ROOTS.
• Escrita bloqueada em diretórios protegidos do sistema (C:\Windows, Program Files, /etc, /usr…) e em pastas sensíveis do home (.ssh, .aws, .gnupg, .kube, .docker…).