MDMagic MCPサーバー

独自のWordテンプレート（レターヘッド、ブランディング、フォントなど）を使用して、MarkdownをDOCX、PDF、HTMLに変換します。 独自のテンプレートがない場合でも、デザイナーが作成した15種類のテンプレートが利用可能です。

MDMagicは、Claude、Cursor、VS Code、およびMCP互換のAIアシスタントに直接接続し、プロフェッショナルなドキュメント変換パイプライン（Pandoc + Microsoft Graph + Mammoth.js）への直接アクセスを提供します。さらに重要なのは、あなたのテンプレートが使えることです。既存のレターヘッド、便箋、ブランドガイドライン、契約書、提案書テンプレートなど、Microsoft Wordで普段使用しているものをアップロードすれば、AIアシスタントがMarkdownを直接変換し、あなたのロゴ、フォント、色、フッター、ページ番号、透かし、署名ブロックを備えた洗練されたドキュメントを作成します。出力結果は、一般的なAIによるエクスポートではなく、デザインチームが作成したかのような仕上がりになります。

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に追加してください（または設定 → 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"
      }
    }
  }
}

ホスト型 (インストール不要)

ユーザーのPCに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

できること

接続後、AIアシスタントに以下のように指示できます：

• 「このMarkdownをExecutive_Platinumテンプレートを使ってPDFに変換して。」

• 「利用可能なテンプレートは何ですか？」

• 「この800語のレポートをDOCXとPDFに変換するコストはいくらですか？」

• 「これを横向き、USレターサイズ、Legal_Burgundyテンプレートでレンダリングして。」

• 「クレジット残高を確認して。」

AIが適切なツールを選択し、安全で期限付きのダウンロードリンクを返します。

ツール

convert_document — 入力オプション

ソースを提供する方法は3つあります：

• content — 生のMarkdown文字列（最も一般的）

• filePath — .mdファイルへの絶対パス（IDEワークフローに最適）

• fileContent — Base64エンコードされたMarkdown（バイナリセーフな転送用）

さらに：

• 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ページあたり1クレジット（基本）

• PDF: +1ページあたり1クレジット

• HTML: +1ページあたり1クレジット

• カスタムテンプレート: +1ページあたり1クレジット

カスタムテンプレートを使用して5ページのレポートをDOCX + PDF + HTMLに変換する場合 = 5 × (1 + 1 + 1 + 1) = 20クレジット。

estimate_conversion_cost ツールを使用すると、実行前に正確な数値を確認できます。また、残高が不足している場合はMCPが実行を拒否するため、予期せぬ請求が発生することはありません。

無料枠のクレジットは毎月更新されます。有料プランやクレジットの追加購入は mdmagic.ai で可能です。

プライバシー

• 永続的な保存は行いません。 ドキュメントはPDFレンダリングのためにMicrosoft Graph APIを通過し、5〜10秒以内に削除されます。出力ファイルは、ダウンロード後または60分後のいずれか早い方でMDMagicサーバーから削除されます。

• ランダムなファイル名。 ソースファイルにはUUIDが使用され、ユーザーを特定できる名前は決して使用されません。

• 安全なダウンロードURL。 各変換は、セッションIDとダウンロードトークンを含むワンタイムURLを返します。公開ファイルディレクトリはありません。

• APIキーの分離。 各ユーザーは自身のキーで認証します。資格情報の共有はありません。

トラブルシューティング

MDMAGIC_API_KEY environment variable is required クライアント設定（JSON内の env ブロック）で環境変数を設定してください。シェルで設定しても npx は認識しません。

Invalid API key format キーは mdmagic- に続く16桁の数字である必要があります。アカウントページから正確にコピーしてください。

Failed to connect to MDMagic API ブラウザで https://api.mdmagic.ai/health を確認してください。サイトが稼働している場合、問題はローカルネットワークまたはファイアウォールにあります。MCPを実行しているマシンから MDMAGIC_BASE_URL（デフォルト https://api.mdmagic.ai）に到達できることを確認してください。

ツールがClaude Desktopに表示されない claude_desktop_config.json を編集した後は、Claude Desktopを完全に終了してから再起動してください（ウィンドウを閉じるだけでは不十分です）。

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) は、サーバーツールを個別にテストするためのWeb UIを起動します。新しいツールの追加や引数の検証のデバッグに便利です。

テストを実行するには npm test を使用します。

リンク

• MDMagic — mdmagic.ai

• APIキーの取得 — mdmagic.ai/account

• 問題報告 — github.com/MDMagic-MCP/mdmagic-mcp-server/issues

• MCP仕様 — modelcontextprotocol.io

ライセンス

MIT — LICENSE を参照してください。