document-generator-mcp

generar pdf y word

GitHub
7
Prueba este MCPPatrocinado

Documentación

Document Generator MCP

Un servidor MCP (Model Context Protocol) para generar documentos profesionales de Word (.docx) y PDF desde cualquier agente de IA que admita MCP, incluidos Claude Desktop, Amazon Q Developer, Cline, Continue y otros.

🚀 Características

  • ✅ Genera documentos de Word (.docx)
  • ✅ Genera documentos PDF
  • ✅ Detección automática de bloques JSON (¡sin necesidad de backticks!) 🆕
  • ✅ Resaltado de sintaxis profesional (tema VS Code Dark)
  • ✅ Paginación inteligente (sin cortes de contenido entre páginas)
  • ✅ Formato 100% adaptable (respeta los márgenes A4)
  • ✅ Soporte de Markdown (encabezados, listas, negrita, cursiva, bloques de código)
  • ✅ Formato profesional automático
  • ✅ Metadatos (autor, fecha de creación)

📦 Instalación

Mediante NPX (Recomendado)

npx document-generator-mcp@latest

Mediante NPM Global

npm install -g document-generator-mcp

⚙️ Configuración

Claude Desktop

  1. Localiza el archivo de configuración:

    • 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. Añade esta configuración:

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

Amazon Q Developer

  1. Abre VS Code con la extensión de Amazon Q
  2. Accede a la configuración de Amazon Q
  3. Añade el servidor MCP:
{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}

Otros Agentes MCP (Cline, Continue, etc.)

Para otros agentes que admitan MCP, añade la configuración del servidor:

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

Consulta la documentación específica de tu agente para los detalles de configuración.

🎯 Cómo Usar

Después de la configuración, puedes usar comandos en lenguaje natural en cualquier agente MCP:

Ejemplos de Prompts

  • "Crea un documento de Word sobre análisis de ventas"
  • "Genera un informe PDF sobre el proyecto"
  • "Haz un manual técnico en Word y PDF"
  • "Crea documentación de API en formato Word"
  • "Documenta este código JavaScript con ejemplos"

Herramientas Disponibles

  • gerar_documento_word: Crea documentos de Word, PDF, o ambos
  • gerar_documento_pdf: Crea solo documentos PDF

📝 Formato Soportado

El MCP procesa automáticamente:

Markdown

  • # Heading 1 → Encabezado 1 (20pt)
  • ## Heading 2 → Encabezado 2 (16pt, azul)
  • ### Heading 3 → Encabezado 3 (14pt)
  • #### Heading 4 → Encabezado 4 (12pt)
  • - Item → Lista con viñetas
  • 1. Item → Lista numerada
  • **text** → Texto en negrita
  • *text* → Texto en cursiva
  • ***text*** → Negrita + Cursiva
  • `code` → Código en línea
  • > quote → Cita en bloque
  • --- → Línea horizontal

Bloques de Código

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

JSON Auto-Detectado (¡Nuevo en v1.0.9!)

Los objetos y arrays JSON se detectan automáticamente y se formatean como bloques de código:

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

¡No necesitas backticks ```! Simplemente pega tu JSON y se formateará automáticamente con resaltado de sintaxis.

Colores de Resaltado de Sintaxis (tema VS Code Dark):

  • 🟣 Palabras clave: async, function, const, await, etc. (#C586C0)
  • 🟠 Cadenas: "text", 'text' (#CE9178)
  • 🟢 Comentarios: // comment, /* block */ (#6A9955)
  • 🟢 Números: 42, 3.14, 0xFF (#B5CEA8)
  • 🟡 Funciones: fetch, console.log (#DCDCAA)
  • 🔵 Tipos/Clases: Promise, Array (#4EC9B0)

🎨 Aspectos Destacados

Resaltado de Sintaxis Profesional

  • Fondo oscuro (#1E1E1E) para bloques de código
  • Colores del tema VS Code Dark
  • Indicador de lenguaje en el encabezado
  • Ajuste automático de líneas

Paginación Inteligente

  • Los bloques de código nunca se dividen entre páginas
  • Los encabezados se mantienen con el contenido siguiente
  • Saltos de página automáticos cuando es necesario
  • Espaciado consistente

Formato Adaptable

  • Todo el contenido respeta los márgenes A4
  • Saltos de línea automáticos para texto largo
  • Control de ancho adecuado para todos los elementos
  • Sin desbordamiento de contenido

🧪 Pruebas

Para comprobar si funciona:

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

Salida esperada: Lista de herramientas disponibles (gerar_documento_word, gerar_documento_pdf)

🔧 Solución de Problemas

Error "use strict: not found"

Si recibes este error, npm está usando una versión antigua en caché. Soluciones:

  1. Usa esta configuración optimizada:
{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}
  1. O limpia la caché:
npm cache clean --force
rm -rf ~/.npm/_npx

Los documentos no se generan

  • Comprueba si existe la carpeta generated_documents/
  • Verifica la versión de Node.js (se requiere 18+)
  • Revisa los registros del servidor MCP en tu agente

📁 Archivos Generados

Los documentos se guardan en ./generated_documents/ con marcas de tiempo únicas.

Ejemplo: api_documentation_1759715959772.docx

🤖 Agentes Compatibles

Este MCP funciona con cualquier agente que implemente el Model Context Protocol:

  • ✅ Claude Desktop - Soporte nativo completo
  • ✅ Amazon Q Developer - Soporte mediante VS Code
  • ✅ Cline (VS Code) - Extensión de VS Code
  • ✅ Continue - Asistente de código con MCP
  • ✅ Otros agentes MCP - Cualquier implementación compatible

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Abre issues o pull requests en GitHub.

Configuración de Desarrollo

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

📄 Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.

🔗 Enlaces

⚠️ Requisitos

  • Node.js: Se requiere 18+
  • Plataformas: Linux, macOS, Windows
  • Soporte MCP: Cualquier agente que implemente el Model Context Protocol

📊 Registro de Cambios

v1.0.9 (Última versión)

  • ✅ Bloques JSON auto-detectados - Sin necesidad de backticks ``` alrededor del JSON
  • ✅ Formatea automáticamente objetos y arrays JSON como bloques de código
  • ✅ Valida la sintaxis JSON antes de formatear
  • ✅ Aplica resaltado de sintaxis al JSON detectado
  • ✅ Funciona en documentos de Word y PDF

v1.0.8

  • ✅ Documentación en inglés para audiencia internacional
  • ✅ Estructura mejorada del README

v1.0.7

  • ✅ Resaltado de sintaxis profesional en PDF (tema VS Code Dark)
  • ✅ Formato 100% adaptable (respeta los márgenes A4)
  • ✅ Paginación inteligente (sin cortes de contenido)
  • ✅ Espaciado mejorado después de bloques de código
  • ✅ Paridad visual entre Word y PDF

Hecho con ❤️ por Thiago Oliveira

¡Transforma el lenguaje natural en documentos profesionales con IA!