MDMagic MCP Server

MDMagic MCP Server

お使いの 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@latest"],
      "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@latest"],
      "env": {
        "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

VS Code（MCP 拡張機能を使用）

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

ホステッド（インストール不要）

ユーザーのマシンに Node をインストールしたくない場合は、ホステッドエンドポイントを使用します。

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

同じツール、同じテンプレートを Streamable HTTP 経由で利用できます。ローカルプロセスを実行しないクライアントに便利です。

できること

接続したら、AI アシスタントに次のように依頼できます。

• 「Executive_Platinum テンプレートを使って、この Markdown を PDF に変換してください。」
• 「利用できるテンプレートを教えてください。」
• 「この 800 語のレポートを DOCX と PDF にレンダリングすると、何クレジットかかりますか？」
• 「Legal_Burgundy テンプレートを使い、横向き、US Letter でレンダリングしてください。」
• 「クレジット残高を確認してください。」

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

ツール

ツール	機能
convert_document	Markdown を DOCX／PDF／HTML、または 3 形式すべてに変換します。安全な有効期限付き URL を返します。
validate_markdown	変換前のチェックを実行します。形式が不正な表、閉じられていないコードフェンスなど、出力が壊れる原因となる構文上の問題を検出します。
estimate_conversion_cost	単語数、ページ数、形式、テンプレートの種類に基づいて、変換前に費用を見積もります。
check_credit_balance	現在のクレジット残高（サブスクリプション分 + 購入済みプール）とプランのステータスを表示します。
list_all_templates	テンプレートの完全なカタログを表示します。標準テンプレート 15 種類（カテゴリー別）と、アップロードしたカスタムテンプレートが含まれます。
list_builtin_templates	標準テンプレートのみを表示します。ビジネス（5 種類）、クリエイティブ（6 種類）、プロフェッショナル（2 種類）、テクニカル（2 種類）があります。
list_custom_templates	アップロードしたカスタムテンプレートのみを表示します。
get_template_details	指定したテンプレートで利用できるバリエーション（用紙サイズ × 向き）を表示します。
recommend_template	説明された目的（「第 4 四半期の役員会資料」→ Executive_Platinum など）に最適な標準テンプレートを提案します。
show_default_settings	デフォルトの用紙サイズ、向き、テンプレートの設定を表示します。

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	(必須)	mdmagic.ai/account で取得できる個人用APIキー
MDMAGIC_BASE_URL	https://api.mdmagic.ai	ローカル開発環境またはステージング環境でのみ上書きしてください
REQUEST_TIMEOUT	30000	リクエストのタイムアウト（ミリ秒）
MCP_TRANSPORT	stdio	stdio（デフォルト）またはセルフホスト可能なStreamable HTTP用の http
MCP_HTTP_PORT	3001	HTTPトランスポートモードのポート
MCP_HTTP_HOST	127.0.0.1	HTTPトランスポートモードのバインドアドレス

ほとんどのユーザーが設定するのは MDMAGIC_API_KEY だけです。

料金

変換にはクレジットが必要です。ページ数と出力形式に基づいて計算されます。

• DOCX：1ページあたり1クレジット（基本）
• PDF：1ページあたり1クレジット追加
• HTML：1ページあたり1クレジット追加
• カスタムテンプレート：1ページあたり1クレジット追加

5ページのレポートをカスタムテンプレートを使ってDOCX、PDF、HTMLに変換すると、5 × (1 + 1 + 1 + 1) = 20 credits になります。

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 クライアント設定の env ブロック（JSON）に環境変数を設定してください。シェルには設定しないでください。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 Inspector（npm run inspector）を実行すると、サーバーのツールを1つずつ試せるWeb UIが起動します。新しいツールの追加や、引数の検証のデバッグに便利です。

テストは npm test で実行できます。

リンク

• MDMagic — mdmagic.ai
• APIキーを取得 — mdmagic.ai/account
• 問題の報告 — github.com/MDMagic-MCP/mdmagic-mcp-server/issues
• MCP仕様 — modelcontextprotocol.io

ライセンス

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