md2doc - Servidor MCP de Markdown a DOCX

Un servidor del Protocolo de Contexto de Modelo (MCP) que convierte texto Markdown a formato DOCX utilizando un servicio de conversión externo.

Características

• Convertir texto Markdown a formato DOCX

• Soporte para plantillas personalizadas

• Soporte multilingüe (inglés, chino, etc.)

• Descarga automática de archivos al directorio de descargas del usuario

• Listado y gestión de plantillas

Uso

Cherry Studio

1. Abre Cherry Studio

2. Ve a Ajustes → MCP

3. Añade la configuración del servidor:

   {
     "mcpServers": {
       "md2doc": {
         "command": "uvx",
         "args": ["md2doc"],
         "env": {
           "DEEP_SHARE_API_KEY": "your-api-key-here"
         }
       }
     }
   }

Claude Desktop

1. Abre tu archivo de configuración de Claude Desktop:

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

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

2. Añade el servidor md2doc:

   {
     "mcpServers": {
       "md2doc": {
         "command": "uvx",
         "args": ["md2doc"],
         "env": {
           "DEEP_SHARE_API_KEY": "your-api-key-here"
         }
       }
     }
   }

3. Reinicia Claude Desktop

Línea de comandos (Inicio rápido)

Para uso inmediato sin ninguna configuración de cliente:

# Install and run the server
uvx md2doc

# Or with environment variable
DEEP_SHARE_API_KEY="your-api-key-here" uvx md2doc

Integración con Python

También puedes usar md2doc directamente en tus proyectos de Python:

import asyncio
from md2doc.api_client import ConversionAPIClient
from md2doc.models import ConvertTextRequest

async def convert_markdown():
    client = ConversionAPIClient()
    
    request = ConvertTextRequest(
        content="# Hello World\n\nThis is **markdown** content.",
        filename="example",
        language="zh",
        template_name="templates",
        remove_hr=False,
        compat_mode=True
    )
    
    response = await client.convert_text(request)
    if response.success:
        print(f"File saved to: {response.file_path}")

# Run the conversion
asyncio.run(convert_markdown())

Otros clientes MCP

El servidor funciona con cualquier cliente compatible con MCP. Configúralo para ejecutar:

uvx md2doc

Con variables de entorno:

DEEP_SHARE_API_KEY="your-api-key-here" uvx md2doc

Implementación en la nube (Servidor remoto)

Al implementar este servidor MCP en un servidor en la nube (VPS/Docker), establece MCP_SAVE_REMOTE=true para devolver un enlace de descarga temporal en lugar de guardar en un directorio local:

# In your cloud environment
export DEEP_SHARE_API_KEY="your-api-key-here"
export MCP_SAVE_REMOTE=true

uvx md2doc

El servidor proporcionará un enlace de descarga para el documento convertido.

Clave de API

Clave de API de prueba gratuita

Usa esta clave para realizar pruebas:

f4e8fe6f-e39e-486f-b7e7-e037d2ec216f

Comprar clave de API

• Enlace de compra

• 中国大陆购买

Herramientas disponibles

• convert_markdown_to_docx: Convierte texto markdown a DOCX

• list_templates: Obtiene las plantillas disponibles por idioma

Licencia

MIT