MDMagic MCP Server

Преобразуйте Markdown в DOCX, PDF и HTML, используя собственные шаблоны Word — с вашими фирменными бланками, брендингом и шрифтами. Плюс 15 дизайнерских шаблонов на случай, если у вас нет своих.

MDMagic подключается напрямую к Claude, Cursor, VS Code и любому другому ИИ-ассистенту с поддержкой MCP, предоставляя им прямой доступ к профессиональному конвейеру преобразования документов (Pandoc + Microsoft Graph + Mammoth.js) и, что более важно, к вашим шаблонам. Загрузите свои фирменные бланки, шаблоны договоров, коммерческих предложений или руководства по бренду — всё, что вы уже используете в Microsoft Word, — и ваш ИИ-ассистент сможет конвертировать любой Markdown напрямую в отполированный документ с вашим логотипом, шрифтами, цветами, колонтитулами, нумерацией страниц, водяными знаками и блоками подписей. Результат выглядит так, будто его подготовила ваша команда дизайнеров, а не просто сгенерировал ИИ.

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.

Установка

Вам потребуется учетная запись MDMagic (доступен бесплатный тариф) и API-ключ с вашей страницы учетной записи.

Claude Desktop

Добавьте это в ваш claude_desktop_config.json:

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

Расположение файла конфигурации:

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

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

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

Перезапустите Claude Desktop. Инструменты MDMagic появятся в списке инструментов.

Cursor

Добавьте в ~/.cursor/mcp.json (или через Settings → MCP):

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

VS Code (с расширением MCP)

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

Хостинг (без установки)

Не хотите устанавливать Node на компьютер? Используйте хостинг-эндпоинт:

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

Те же инструменты, те же шаблоны, работающие через Streamable HTTP. Полезно для клиентов, которые не запускают локальные процессы.

Related MCP server: AI Group Markdown to Word MCP Server

Что вы можете делать

После подключения попросите своего ИИ-ассистента сделать следующее:

• "Преобразуй этот markdown в PDF, используя шаблон Executive_Platinum."

• "Какие шаблоны мне доступны?"

• "Сколько кредитов будет стоить рендеринг этого отчета на 800 слов в формате DOCX + PDF?"

• "Отрендери это в альбомной ориентации, на бумаге формата US Letter, с шаблоном Legal_Burgundy."

• "Проверь мой баланс кредитов."

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

Инструменты

convert_document — параметры ввода

Три способа предоставить исходный код:

• content — необработанная строка markdown (наиболее часто используется)

• filePath — абсолютный путь к файлу .md (отлично подходит для рабочих процессов в IDE)

• fileContent — markdown в кодировке base64 (для безопасной передачи бинарных данных)

Плюс:

• templateName — например, Executive_Platinum, Legal_Burgundy или UUID пользовательского шаблона

• outputFormat — docx, pdf, html, all или all-formats

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

• orientation — Portrait или Landscape

Конфигурация

Большинству пользователей нужно будет установить только MDMAGIC_API_KEY.

Ценообразование

Конвертации стоят кредитов, рассчитываемых на основе количества страниц и формата вывода:

• DOCX: 1 кредит за страницу (база)

• PDF: +1 кредит за страницу

• HTML: +1 кредит за страницу

• Пользовательские шаблоны: +1 кредит за страницу

Отчет на 5 страниц, преобразованный в DOCX + PDF + HTML с использованием пользовательского шаблона = 5 × (1 + 1 + 1 + 1) = 20 кредитов.

Инструмент estimate_conversion_cost возвращает точные цифры до того, как вы что-либо потратите. MCP также отказывается работать, если ваш баланс слишком низкий — никаких неожиданных счетов.

Кредиты бесплатного тарифа обновляются ежемесячно. Платные планы и пополнение кредитов доступны на mdmagic.ai.

Конфиденциальность

• Никакого постоянного хранения. Документы проходят через Microsoft Graph API для рендеринга PDF и удаляются в течение 5–10 секунд. Выходные файлы удаляются с серверов MDMagic после скачивания или через 60 минут, в зависимости от того, что наступит раньше.

• Случайные имена файлов. Исходные файлы используют UUID, никогда не используются имена, идентифицирующие пользователя.

• Безопасные URL для скачивания. Каждая конвертация возвращает одноразовый URL с ID сессии и токеном скачивания. Никаких публичных директорий с файлами.

• Изоляция API-ключей. Каждый пользователь аутентифицируется своим собственным ключом. Никаких общих учетных данных.

Устранение неполадок

MDMAGIC_API_KEY environment variable is required Установите переменную окружения в конфигурации вашего клиента (блок env в JSON). Не помещайте ее в оболочку (shell) — npx ее не увидит.

Invalid API key format Ключи должны соответствовать формату mdmagic-, за которым следуют ровно 16 цифр. Скопируйте его аккуратно со страницы вашей учетной записи.

Failed to connect to MDMagic API Проверьте https://api.mdmagic.ai/health в браузере. Если он работает, проблема в локальной сети или брандмауэре. Убедитесь, что MDMAGIC_BASE_URL (по умолчанию https://api.mdmagic.ai) доступен с машины, на которой запущен MCP.

Инструменты не появляются в Claude Desktop Полностью завершите работу и перезапустите Claude Desktop после редактирования claude_desktop_config.json — простого закрытия окна недостаточно.

Insufficient credits Используйте check_credit_balance для подтверждения баланса, estimate_conversion_cost для предварительного просмотра затрат или пополните счет на mdmagic.ai/account.

Локальная разработка

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

Инспектор MCP (npm run inspector) запускает веб-интерфейс для проверки сервера инструмент за инструментом — полезно при добавлении новых инструментов или отладке проверки аргументов.

Запускайте тесты с помощью npm test.

Ссылки

• MDMagic — mdmagic.ai

• Получить API-ключ — mdmagic.ai/account

• Проблемы — github.com/MDMagic-MCP/mdmagic-mcp-server/issues

• Спецификация MCP — modelcontextprotocol.io

Лицензия

MIT — см. LICENSE.