DocGen MCP Server

O que é

Servidor Model Context Protocol (MCP) 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

Segurança

• Sem .. nos caminhos; leitura limitada por tamanho de ficheiro.
• Escrita bloqueada em pastas do sistema (ex.: Windows, Program Files, .ssh, .aws no home).
• Opcional: DOCGEN_ALLOWED_ROOTS — lista separada por vírgulas de pastas absolutas; só é permitido ler/escrever dentro delas (útil em monorepos/CI).

Variáveis de ambiente (opcional)

Erros das tools devolvem structuredContent com ok: false, code, tool, message e às vezes hint.

Como usar nos clientes (recomendado: PyPI)

Em qualquer cliente MCP com transporte stdio:

• Comando: uvx.
• Argumentos: ["docgen-mcp-server"] (ou ["--from", "docgen-mcp-server==0.2.2", "docgen-mcp-server"] para uma versão fixa).
• Variáveis de ambiente: opcionais; veja as variáveis do Playwright/Chromium se precisar de proxy ou caminho de browser.

Exemplo (Cursor, VS Code com MCP, Claude Desktop, etc.):

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

No repositório há um exemplo em .cursor/mcp.json.example.

Cursor

Configurações → MCP (ou JSON de MCP do projeto): use command, args e env como acima.

Claude Desktop

Mesmo esquema de command, args e env. Detalhes de caminho do arquivo de configuração variam por SO; veja a documentação da Anthropic sobre MCP.

Problemas comuns na instalação

Se uvx não for encontrado, instale o uv. Para atualizar uma instalação em cache, use uvx --refresh docgen-mcp-server.

Se a ferramenta de renderização reclamar de navegador, instale o Chromium com playwright install chromium ou configure o caminho de um Chrome já instalado.

Desenvolvimento a partir do clone

git clone <repo>
cd docgen-mcp-server
uv sync
uv run docgen-mcp-server

Sem build prévio (local):

uv run docgen-mcp-server

Publicação no PyPI (mantenedores)

uv build
uv publish --dry-run
uv publish

Licença

ISC