md2doc — MCP-сервер для преобразования Markdown в DOCX

Сервер протокола контекста модели (MCP), который преобразует текст в формате Markdown в формат DOCX с использованием внешнего сервиса конвертации.

Функции

• Преобразование текста Markdown в формат DOCX

• Поддержка пользовательских шаблонов

• Многоязычная поддержка (английский, китайский и др.)

• Автоматическая загрузка файлов в папку «Загрузки» пользователя

• Просмотр и управление шаблонами

Использование

Cherry Studio

1. Откройте Cherry Studio

2. Перейдите в «Настройки» → «MCP»

3. Добавьте конфигурацию сервера:

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

Claude Desktop

1. Откройте файл конфигурации Claude Desktop:

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

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

2. Добавьте сервер md2doc:

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

3. Перезапустите Claude Desktop

Командная строка (быстрый старт)

Для немедленного использования без настройки клиента:

# Install and run the server
uvx md2doc

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

Интеграция с Python

Вы также можете использовать md2doc напрямую в своих проектах на 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())

Другие MCP-клиенты

Сервер работает с любым MCP-совместимым клиентом. Настройте его запуск:

uvx md2doc

С переменными окружения:

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

Облачное развертывание (удаленный сервер)

При развертывании этого MCP-сервера на облачном сервере (VPS/Docker) установите MCP_SAVE_REMOTE=true, чтобы получать временную ссылку для скачивания вместо сохранения в локальную директорию:

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

uvx md2doc

Сервер предоставит ссылку для скачивания преобразованного документа.

API-ключ

Бесплатный пробный API-ключ

Используйте этот ключ для тестирования:

f4e8fe6f-e39e-486f-b7e7-e037d2ec216f

Покупка API-ключа

• Ссылка на покупку

• 中国大陆购买

Доступные инструменты

• convert_markdown_to_docx: преобразование текста markdown в DOCX

• list_templates: получение доступных шаблонов по языку

Лицензия

MIT