MDMagic MCP Server

Konvertieren Sie Markdown in DOCX, PDF und HTML unter Verwendung Ihrer eigenen Word-Vorlagen – mit Ihrem Briefpapier, Ihrem Branding und Ihren Schriftarten. Plus 15 von Designern erstellte Vorlagen für den Fall, dass Sie keine eigenen haben.

👁 npm version
👁 MCP Registry
👁 Smithery
👁 license

MDMagic lässt sich direkt in Claude, Cursor, VS Code und jeden anderen MCP-kompatiblen KI-Assistenten integrieren – und bietet diesen direkten Zugriff auf eine professionelle Dokumenten-Konvertierungspipeline (Pandoc + Microsoft Graph + Mammoth.js) und, was noch wichtiger ist, auf Ihre Vorlagen. Laden Sie Ihr vorhandenes Briefpapier, Ihre Geschäftsausstattung, Markenrichtlinien, Vertragsvorlagen oder Angebotsvorlagen hoch – alles, was Sie bereits in Microsoft Word verwenden – und Ihr KI-Assistent kann jedes Markdown direkt in ein ausgefeiltes Dokument umwandeln, das Ihr Logo, Ihre Schriftarten, Farben, Fußzeilen, Seitenzahlen, Wasserzeichen und Signaturblöcke enthält. Das Ergebnis sieht aus, als käme es von Ihrem Design-Team und nicht aus einem generischen KI-Export.

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.

Installation

Sie benötigen ein MDMagic-Konto (kostenlose Stufe verfügbar) und Ihren API-Schlüssel von Ihrer Kontoseite.

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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

Speicherort der Konfigurationsdatei:

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

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

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

Starten Sie Claude Desktop neu. Die MDMagic-Tools erscheinen in der Tool-Liste.

Cursor

Fügen Sie dies zu ~/.cursor/mcp.json hinzu (oder über Einstellungen → MCP):

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

VS Code (mit einer MCP-Erweiterung)

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

Gehostet (keine Installation)

Sie möchten kein Node auf dem Rechner des Benutzers? Verwenden Sie den gehosteten Endpunkt:

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

Dieselben Tools, dieselben Vorlagen, bereitgestellt über Streamable HTTP. Nützlich für Clients, die keine lokalen Prozesse ausführen.

Related MCP server: AI Group Markdown to Word MCP Server

Was Sie tun können

Sobald die Verbindung hergestellt ist, können Sie Ihren KI-Assistenten Dinge fragen wie:

• "Konvertiere dieses Markdown in ein PDF unter Verwendung der Vorlage Executive_Platinum."

• "Welche Vorlagen stehen mir zur Verfügung?"

• "Wie viele Credits kostet es, diesen 800-Wörter-Bericht als DOCX + PDF zu rendern?"

• "Rendere dies im Querformat, US Letter, mit der Vorlage Legal_Burgundy."

• "Überprüfe mein Guthaben."

Die KI wählt das richtige Tool aus und gibt einen sicheren, zeitlich begrenzten Download-Link zurück.

Tools

convert_document — Eingabeoptionen

Drei Möglichkeiten, die Quelle bereitzustellen:

• content — roher Markdown-String (am häufigsten)

• filePath — absoluter Pfad zu einer .md-Datei (ideal für IDE-Workflows)

• fileContent — base64-kodiertes Markdown (für binärsichere Transporte)

Plus:

• templateName — z. B. Executive_Platinum, Legal_Burgundy oder eine benutzerdefinierte Vorlagen-UUID

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

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

• orientation — Portrait oder Landscape

Konfiguration

Die meisten Benutzer werden nur MDMAGIC_API_KEY festlegen.

Preisgestaltung

Konvertierungen kosten Credits, berechnet nach Seitenzahl und Ausgabeformat:

• DOCX: 1 Credit pro Seite (Basis)

• PDF: +1 Credit pro Seite

• HTML: +1 Credit pro Seite

• Benutzerdefinierte Vorlagen: +1 Credit pro Seite

Ein 5-seitiger Bericht, konvertiert in DOCX + PDF + HTML unter Verwendung einer benutzerdefinierten Vorlage = 5 × (1 + 1 + 1 + 1) = 20 Credits.

Das Tool estimate_conversion_cost gibt exakte Zahlen zurück, bevor Sie etwas ausgeben. Das MCP verweigert zudem die Ausführung, wenn Ihr Guthaben zu niedrig ist – keine unerwarteten Rechnungen.

Credits der kostenlosen Stufe erneuern sich monatlich. Bezahlte Pläne und Credit-Aufladungen sind unter mdmagic.ai verfügbar.

Datenschutz

• Keine dauerhafte Speicherung. Dokumente durchlaufen die Microsoft Graph API für das PDF-Rendering und werden innerhalb von 5–10 Sekunden gelöscht. Ausgabedateien werden nach dem Download oder nach 60 Minuten von den MDMagic-Servern gelöscht, je nachdem, was zuerst eintritt.

• Zufällige Dateinamen. Quelldateien verwenden UUIDs, niemals identifizierbare Namen.

• Sichere Download-URLs. Jede Konvertierung gibt eine Einmal-URL mit Sitzungs-ID und Download-Token zurück. Keine öffentlichen Dateiverzeichnisse.

• API-Schlüssel-Isolierung. Jeder Benutzer authentifiziert sich mit seinem eigenen Schlüssel. Keine geteilten Anmeldedaten.

Fehlerbehebung

MDMAGIC_API_KEY environment variable is required Setzen Sie die Umgebungsvariable in Ihrer Client-Konfiguration (der env-Block im JSON). Setzen Sie sie nicht in einer Shell – npx wird sie nicht sehen.

Invalid API key format Schlüssel müssen mit mdmagic- gefolgt von genau 16 Ziffern übereinstimmen. Kopieren Sie ihn sauber von Ihrer Kontoseite.

Failed to connect to MDMagic API Überprüfen Sie https://api.mdmagic.ai/health in einem Browser. Wenn die Seite erreichbar ist, liegt das Problem am lokalen Netzwerk oder der Firewall. Bestätigen Sie, dass MDMAGIC_BASE_URL (Standard https://api.mdmagic.ai) von der Maschine aus erreichbar ist, auf der das MCP läuft.

Tools erscheinen nicht in Claude Desktop Beenden Sie Claude Desktop vollständig und starten Sie es neu, nachdem Sie claude_desktop_config.json bearbeitet haben – ein einfaches Schließen des Fensters reicht nicht aus.

Insufficient credits Verwenden Sie check_credit_balance, um das Guthaben zu bestätigen, estimate_conversion_cost, um die Kosten vorab zu sehen, oder laden Sie unter mdmagic.ai/account auf.

Lokale Entwicklung

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

Der MCP Inspector (npm run inspector) startet eine Web-UI zum Testen des Servers Tool für Tool – nützlich beim Hinzufügen neuer Tools oder beim Debuggen der Argumentvalidierung.

Führen Sie Tests mit npm test aus.

Links

• MDMagic — mdmagic.ai

• API-Schlüssel erhalten — mdmagic.ai/account

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

• MCP-Spezifikation — modelcontextprotocol.io

Lizenz

MIT — siehe 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