docgen-mcp-server

# DocGen MCP Server ## O que é Servidor [Model Context Protocol (MCP)](https://modelcontextprotocol.io) via **stdio** para leitura e escrita de documentos, planilhas, renderização HTML→PDF (Playwright) e utilitários de arquivo. É distribuído no PyPI como **`docgen-mcp-server`** e requer **Python 3.11+**. Recomenda-se executar com **`uvx docgen-mcp-server`**. Para travar em uma versão, use `uvx --from docgen-mcp-server==0.2.2 docgen-mcp-server`. Na primeira execução, o Playwright pode precisar de um navegador Chromium/Chrome instalado (tools `render_page` e `render_image`). `render_slide` gera o arquivo PowerPoint diretamente, sem navegador. ## Ferramentas | Módulo | Ferramenta | Descrição resumida | |--------|------------|-------------------| | **read_** | `read_doc` | `.docx`/`.pdf`/`.odt`/`.pptx` → Markdown; `previewOnly` / `maxChars` limitam saída. | | | `read_sheet` | Planilhas → JSON ou Markdown; `range` tipo `A1:D10`; `previewOnly` / `maxRows`. | | | `read_archive` | Lista árvore de entradas em `.zip`. | | **write_** | `write_doc` | `.docx`/`.pdf`; **Markdown** (`#`, listas, \`\`\`) ou blocos JSON tipados; template `{{campo}}`. | | | `write_sheet` | `.xlsx` ou `.csv`; `append` em `.xlsx` para logs. | | **render_** | `render_slide` | HTML/CSS → PowerPoint `.pptx` (use `<section>` ou `.slide` por slide; `assetBasePath` resolve imagens relativas e `footerHtml` aceita `{slideNumber}`/`{slideCount}`). | | | `render_page` | HTML/CSS → PDF A4 (índice opcional). | | **patch_** | `patch_doc` | PDF: merge, split, watermark; DOCX: `replace_text` em XML. | | | `patch_sheet` | Atualiza células em `.xlsx`. | | **system_** | `scan_dir` | Busca por regex em diretório ou em arquivos/ZIPs. | | | `diff_file` | Diff texto ou dados (planilhas). | | | `bundle_zip` | Compacta lista de arquivos em um ZIP. | ### Segurança - Sem `..` nos caminhos; leitura limitada por tamanho de ficheiro. - **Escrita bloqueada** em pastas do sistema (ex.: `Windows`, `Program Files`, `.ssh`, `.…