document-generator-mcp

gerar pdf e word

GitHub
8
Experimente este MCPPatrocinado

Documentação

Document Generator MCP

Um servidor MCP (Model Context Protocol) para gerar documentos profissionais em Word (.docx) e PDF a partir de qualquer agente de IA compatível com MCP, incluindo Claude Desktop, Amazon Q Developer, Cline, Continue e outros.

🚀 Recursos

  • ✅ Gerar documentos Word (.docx)
  • ✅ Gerar documentos PDF
  • ✅ Detecção automática de blocos JSON (sem necessidade de backticks!) 🆕
  • ✅ Realce de sintaxe profissional (tema VS Code Dark)
  • ✅ Paginação inteligente (sem cortes de conteúdo entre páginas)
  • ✅ Formatação 100% responsiva (respeita margens A4)
  • ✅ Suporte a Markdown (títulos, listas, negrito, itálico, blocos de código)
  • ✅ Formatação profissional automática
  • ✅ Metadados (autor, data de criação)

📦 Instalação

Via NPX (Recomendado)

npx document-generator-mcp@latest

Via NPM Global

npm install -g document-generator-mcp

⚙️ Configuração

Claude Desktop

  1. Localize o arquivo de configuração:

    • Linux: ~/.config/claude-desktop/claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Adicione esta configuração:

{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}
  1. Reinicie o Claude Desktop

Amazon Q Developer

  1. Abra o VS Code com a extensão Amazon Q
  2. Acesse as configurações do Amazon Q
  3. Adicione o servidor MCP:
{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}

Outros Agentes MCP (Cline, Continue, etc.)

Para outros agentes que suportam MCP, adicione a configuração do servidor:

{
  "name": "document-generator",
  "command": "npx",
  "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
}

Consulte a documentação específica do seu agente para detalhes de configuração.

🎯 Como Usar

Após a configuração, você pode usar comandos naturais em qualquer agente MCP:

Exemplos de Prompts

  • "Criar um documento Word sobre análise de vendas"
  • "Gerar um relatório PDF sobre o projeto"
  • "Fazer um manual técnico em Word e PDF"
  • "Criar documentação de API em formato Word"
  • "Documentar este código JavaScript com exemplos"

Ferramentas Disponíveis

  • gerar_documento_word: Cria documentos Word, PDF ou ambos
  • gerar_documento_pdf: Cria apenas documentos PDF

📝 Formatação Suportada

O MCP processa automaticamente:

Markdown

  • # Heading 1 → Título 1 (20pt)
  • ## Heading 2 → Título 2 (16pt, azul)
  • ### Heading 3 → Título 3 (14pt)
  • #### Heading 4 → Título 4 (12pt)
  • - Item → Lista com marcadores
  • 1. Item → Lista numerada
  • **text** → Texto em negrito
  • *text* → Texto em itálico
  • ***text*** → Negrito + Itálico
  • `codigo` → Código inline
  • > quote → Citação em bloco
  • --- → Linha horizontal

Blocos de Código

```javascript
async function example() {
  const data = await fetch('api.com');
  return data.json();
}
```

JSON com Detecção Automática (Novo na v1.0.9!)

Objetos e arrays JSON são detectados automaticamente e formatados como blocos de código:

{
  "status": "success",
  "data": {
    "users": [
      {"id": 1, "name": "John"}
    ]
  }
}

Sem necessidade de backticks ```! Basta colar seu JSON e ele será formatado automaticamente com realce de sintaxe.

Cores do Realce de Sintaxe (tema VS Code Dark):

  • 🟣 Palavras-chave: async, function, const, await, etc. (#C586C0)
  • 🟠 Strings: "text", 'text' (#CE9178)
  • 🟢 Comentários: // comment, /* block */ (#6A9955)
  • 🟢 Números: 42, 3.14, 0xFF (#B5CEA8)
  • 🟡 Funções: fetch, console.log (#DCDCAA)
  • 🔵 Tipos/Classes: Promise, Array (#4EC9B0)

🎨 Destaques dos Recursos

Realce de Sintaxe Profissional

  • Fundo escuro (#1E1E1E) para blocos de código
  • Cores do tema VS Code Dark
  • Cabeçalho indicador de linguagem
  • Quebra de linha automática

Paginação Inteligente

  • Blocos de código nunca são divididos entre páginas
  • Títulos mantidos com o conteúdo seguinte
  • Quebras de página automáticas quando necessário
  • Espaçamento consistente

Formatação Responsiva

  • Todo o conteúdo respeita as margens A4
  • Quebras de linha automáticas para textos longos
  • Controle adequado de largura para todos os elementos
  • Sem estouro de conteúdo

🧪 Testes

Para testar se está funcionando:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx document-generator-mcp@latest

Saída esperada: Lista de ferramentas disponíveis (gerar_documento_word, gerar_documento_pdf)

🔧 Solução de Problemas

Erro "use strict: not found"

Se você receber este erro, o npm está usando uma versão antiga em cache. Soluções:

  1. Use esta configuração otimizada:
{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}
  1. Ou limpe o cache:
npm cache clean --force
rm -rf ~/.npm/_npx

Documentos não estão sendo gerados

  • Verifique se a pasta generated_documents/ existe
  • Verifique a versão do Node.js (18+ necessário)
  • Verifique os logs do servidor MCP no seu agente

📁 Arquivos Gerados

Os documentos são salvos em ./generated_documents/ com carimbos de data/hora exclusivos.

Exemplo: api_documentation_1759715959772.docx

🤖 Agentes Compatíveis

Este MCP funciona com qualquer agente que implemente o Model Context Protocol:

  • ✅ Claude Desktop - Suporte nativo completo
  • ✅ Amazon Q Developer - Suporte via VS Code
  • ✅ Cline (VS Code) - Extensão do VS Code
  • ✅ Continue - Assistente de código com MCP
  • ✅ Outros agentes MCP - Qualquer implementação compatível

🤝 Contribuições

Contribuições são bem-vindas! Abra issues ou pull requests no GitHub.

Configuração de Desenvolvimento

git clone https://github.com/thiagotw10/document-generator-mcp.git
cd document-generator-mcp
npm install
npm run build

📄 Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

🔗 Links

⚠️ Requisitos

  • Node.js: 18+ necessário
  • Plataformas: Linux, macOS, Windows
  • Suporte a MCP: Qualquer agente que implemente o Model Context Protocol

📊 Changelog

v1.0.9 (Mais recente)

  • ✅ Detecção automática de blocos JSON - Sem necessidade de backticks ``` ao redor de JSON
  • ✅ Formata automaticamente objetos e arrays JSON como blocos de código
  • ✅ Valida a sintaxe JSON antes de formatar
  • ✅ Aplica realce de sintaxe ao JSON detectado
  • ✅ Funciona em documentos Word e PDF

v1.0.8

  • ✅ Documentação em inglês para público internacional
  • ✅ Estrutura do README melhorada

v1.0.7

  • ✅ Realce de sintaxe profissional em PDF (tema VS Code Dark)
  • ✅ Formatação 100% responsiva (respeita margens A4)
  • ✅ Paginação inteligente (sem cortes de conteúdo)
  • ✅ Espaçamento melhorado após blocos de código
  • ✅ Paridade visual entre Word e PDF

Feito com ❤️ por Thiago Oliveira

Transforme linguagem natural em documentos profissionais com IA!