Servidor MCP de MDMagic

Convierte Markdown a DOCX, PDF y HTML usando tus propias plantillas de Word: tu membrete, tu marca, tus fuentes. Además, incluye 15 plantillas diseñadas por profesionales para cuando no tengas las tuyas propias.

👁 versión npm
👁 Registro MCP
👁 Smithery
👁 licencia

MDMagic se conecta directamente a Claude, Cursor, VS Code y cualquier asistente de IA compatible con MCP, dándoles acceso directo a una canalización de conversión de documentos profesional (Pandoc + Microsoft Graph + Mammoth.js) y, lo que es más importante, a tus plantillas. Sube tus membretes, papelería, guías de marca, borradores de contratos o plantillas de propuestas existentes (cualquier cosa que ya utilices en Microsoft Word) y tu asistente de IA podrá convertir cualquier Markdown directamente en un documento pulido que incluya tu logotipo, fuentes, colores, pies de página, números de página, marcas de agua y bloques de firma. El resultado parece haber sido creado por tu equipo de diseño, no por una exportación genérica de IA.

You: "Take this report and turn it into an Executive_Platinum PDF."

Claude: ✅ Done. Here's your secure download link.
 14-page PDF, 2.3 MB, expires in 60 minutes.

Instalación

Necesitas una cuenta de MDMagic (hay un nivel gratuito disponible) y tu clave API de tu página de cuenta.

Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
 "mcpServers": {
 "mdmagic": {
 "command": "npx",
 "args": ["-y", "@mdmagic/mcp-server"],
 "env": {
 "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
 }
 }
 }
}

Ubicación del archivo de configuración:

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows — %APPDATA%\Claude\claude_desktop_config.json

• Linux — ~/.config/Claude/claude_desktop_config.json

Reinicia Claude Desktop. Las herramientas de MDMagic aparecerán en la lista de herramientas.

Cursor

Añádelo a ~/.cursor/mcp.json (o a través de Ajustes → MCP):

{
 "mcpServers": {
 "mdmagic": {
 "command": "npx",
 "args": ["-y", "@mdmagic/mcp-server"],
 "env": {
 "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
 }
 }
 }
}

VS Code (con una extensión MCP)

{
 "mcp.servers": {
 "mdmagic": {
 "command": "npx",
 "args": ["-y", "@mdmagic/mcp-server"],
 "env": {
 "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
 }
 }
 }
}

Alojado (sin instalación)

¿No quieres Node en la máquina del usuario? Utiliza el endpoint alojado:

{
 "mcpServers": {
 "mdmagic": {
 "url": "https://api.mdmagic.ai/mcp",
 "headers": {
 "x-api-key": "mdmagic-xxxxxxxxxxxxxxxx"
 }
 }
 }
}

Las mismas herramientas, las mismas plantillas, servidas a través de HTTP Streamable. Útil para clientes que no ejecutan procesos locales.

Related MCP server: AI Group Markdown to Word MCP Server

Qué puedes hacer

Una vez conectado, pide a tu asistente de IA cosas como:

• "Convierte este markdown a PDF usando la plantilla Executive_Platinum."

• "¿Qué plantillas tengo disponibles?"

• "¿Cuántos créditos costará renderizar este informe de 800 palabras como DOCX + PDF?"

• "Renderiza esto en horizontal, tamaño carta (US Letter), con la plantilla Legal_Burgundy."

• "Comprueba mi saldo de créditos."

La IA elige la herramienta adecuada y devuelve un enlace de descarga seguro y de tiempo limitado.

Herramientas

convert_document — opciones de entrada

Tres formas de proporcionar la fuente:

• content — cadena de markdown sin procesar (lo más común)

• filePath — ruta absoluta a un archivo .md (ideal para flujos de trabajo en IDE)

• fileContent — markdown codificado en base64 (para transportes seguros de binarios)

Además:

• templateName — ej. Executive_Platinum, Legal_Burgundy, o un UUID de plantilla personalizada

• outputFormat — docx, pdf, html, all, o all-formats

• pageSize — A4, A3, US_Letter, US_Legal, Executive

• orientation — Portrait o Landscape

Configuración

La mayoría de los usuarios solo configurarán MDMAGIC_API_KEY.

Precios

Las conversiones cuestan créditos, calculados a partir del número de páginas y el formato de salida:

• DOCX: 1 crédito por página (base)

• PDF: +1 crédito por página

• HTML: +1 crédito por página

• Plantillas personalizadas: +1 crédito por página

Un informe de 5 páginas convertido a DOCX + PDF + HTML usando una plantilla personalizada = 5 × (1 + 1 + 1 + 1) = 20 créditos.

La herramienta estimate_conversion_cost devuelve números exactos antes de que gastes nada. El MCP también se niega a ejecutarse si tu saldo es demasiado bajo; sin facturas sorpresa.

Los créditos del nivel gratuito se renuevan mensualmente. Planes de pago y recargas de crédito disponibles en mdmagic.ai.

Privacidad

• Sin almacenamiento permanente. Los documentos pasan a través de la API de Microsoft Graph para la renderización de PDF y se eliminan en 5–10 segundos. Los archivos de salida se eliminan de los servidores de MDMagic después de la descarga o después de 60 minutos, lo que ocurra primero.

• Nombres de archivo aleatorios. Los archivos fuente utilizan UUID, nunca nombres identificables por el usuario.

• URLs de descarga seguras. Cada conversión devuelve una URL de un solo uso con ID de sesión y token de descarga. Sin directorios de archivos públicos.

• Aislamiento de clave API. Cada usuario se autentica con su propia clave. Sin credenciales compartidas.

Solución de problemas

MDMAGIC_API_KEY environment variable is required Establece la variable de entorno en la configuración de tu cliente (el bloque env en el JSON). No la pongas en un shell: npx no la verá.

Invalid API key format Las claves deben coincidir con mdmagic- seguido de exactamente 16 dígitos. Cópiala limpiamente desde tu página de cuenta.

Failed to connect to MDMagic API Comprueba https://api.mdmagic.ai/health en un navegador. Si está activo, el problema es la red local o el firewall. Confirma que MDMAGIC_BASE_URL (predeterminado https://api.mdmagic.ai) sea accesible desde la máquina que ejecuta el MCP.

Las herramientas no aparecen en Claude Desktop Cierra completamente y reinicia Claude Desktop después de editar claude_desktop_config.json: cerrar la ventana no es suficiente.

Insufficient credits Usa check_credit_balance para confirmar el saldo, estimate_conversion_cost para previsualizar costes, o recarga en mdmagic.ai/account.

Desarrollo local

git clone https://github.com/MDMagic-MCP/mdmagic-mcp-server.git
cd mdmagic-mcp-server
npm install

# Set your API key (use http://localhost:3000 if running the API locally)
cp .env.example .env
# edit .env

# Build and inspect
npm run build
npm run inspector

El Inspector MCP (npm run inspector) lanza una interfaz web para probar el servidor herramienta por herramienta, útil al añadir nuevas herramientas o depurar la validación de argumentos.

Ejecuta las pruebas con npm test.

Enlaces

• MDMagic — mdmagic.ai

• Obtener una clave API — mdmagic.ai/account

• Problemas — github.com/MDMagic-MCP/mdmagic-mcp-server/issues

• Especificación MCP — modelcontextprotocol.io

Licencia

MIT: consulta LICENSE.

Maintenance

Resources

• Remote Server
• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• check_credit_balanceA
• convert_documentA
• estimate_conversion_costA
• get_template_detailsA
• list_all_templatesA
• list_builtin_templatesA
• list_custom_templatesA
• recommend_templateA