aigroup-mdtoword-mcp

AI Group Markdown to Word MCP サーバー

高度なスタイル設定、表、数式、画像、Mermaid のレンダリング、HTTP デプロイメントに対応した、MCP 経由のプロフェッショナルな Markdown から Word への変換機能です。

概要

aigroup-mdtoword-mcp は、Markdown コンテンツからプロフェッショナルな .docx ドキュメントを生成する MCP サーバーです。

次の用途を想定して設計されています。

• Markdown を構造化された Word ドキュメントに変換する
• 再利用可能なテンプレートとスタイルプリセットを適用する
• 表、数式、画像、Mermaid 図をレンダリングする
• MCP とシンプルな HTTP エンドポイントの両方を公開する
• Claude Desktop やその他の MCP 対応クライアントと連携する

特長

• ドキュメントのスタイルとレイアウトを制御できる Markdown から DOCX への変換
• 見出し、表、リスト、コードブロック、引用ブロックに対応した 高度な書式設定
• インライン数式とブロック数式に対応した 数式サポート
• ローカルおよびリモートのアセットを埋め込める 画像埋め込み
• コードブロックへの安全なフォールバックに対応した Mermaid のレンダリング
• ヘッダー／フッター／ページ番号／透かしのサポート
• 用途に沿った利用を支援する テンプレート、リソース、プロンプトのサポート
• Cloudflare Worker のワークフローを含む HTTP デプロイメントオプション

クイックスタート

要件

• Node.js >= 18
• npm >= 8

npx で実行

npx -y aigroup-mdtoword-mcp

ローカルにインストール

git clone https://github.com/jackdark425/aigroup-mdtoword-mcp.git
cd aigroup-mdtoword-mcp
npm install
npm run build
npm start

MCP クライアントの設定

Claude Desktop／互換性のある MCP クライアント

{
  "mcpServers": {
    "markdown-to-word": {
      "command": "npx",
      "args": ["-y", "aigroup-mdtoword-mcp"]
    }
  }
}

ローカルビルドの出力

{
  "mcpServers": {
    "markdown-to-word": {
      "command": "node",
      "args": ["/path/to/aigroup-mdtoword-mcp/dist/index.js"]
    }
  }
}

ツール

markdown_to_docx

Markdown コンテンツまたは Markdown ファイルを .docx ドキュメントに変換します。

一般的な入力は次のとおりです。

• markdown
• inputPath
• filename
• outputPath
• styleConfig

table_data_to_markdown

CSV または JSON の表形式データを、書式設定された Markdown の表に変換します。

一般的な入力は次のとおりです。

• data
• format
• style
• hasHeader

リソース

テンプレート

• template://customer-analysis
• template://academic
• template://business
• template://technical
• template://minimal

スタイルガイド

• style-guide://quick-start
• style-guide://advanced
• style-guide://templates

メトリクス

• metrics://conversion-stats
• metrics://memory-usage

スタイリング機能

スタイリングシステムでは、次の設定に対応しています。

• ドキュメント全体のフォント、色、ページレイアウト
• 見出しと段落のスタイル
• 表のプリセットと書式設定
• 画像のサイズと配置
• コードブロックのスタイル
• ヘッダー、フッター、ページ番号、透かし

付属の表スタイルには、一般的なビジネス、学術、金融、技術、簡易レポート向けのレイアウトが含まれています。

使用例

# Project Report

## Executive Summary
This is a sample report with **bold text** and *italic text*.

- Feature 1: Complete Markdown support
- Feature 2: Advanced styling system
- Feature 3: Professional document layout

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Data 1   | Data 2   | Data 3   |
| Data 4   | Data 5   | Data 6   |

Mathematical formula: $E = mc^2$

```mermaid
flowchart TD
  A[Start] --> B{Check input}
  B -->|Valid| C[Generate DOCX]
  B -->|Invalid| D[Return error]
```

デプロイメント

HTTP サーバー

npm run server:http

Cloudflare Worker

npm install -g wrangler
wrangler login
wrangler deploy

関連するエンドポイントは通常、次のとおりです。

• /health
• /mcp
• /convert
• /.well-known/ai-plugin.json
• /openapi.yaml
• /openapi.json

詳しい手順については、docs/DEPLOYMENT_INSTRUCTIONS.md を参照してください。

プロジェクト構成

src/
├── index.ts
├── converter/
├── template/
├── types/
└── utils/

開発

npm run build
npm test

その他のテストコマンド：

• npm run test:math
• npm run test:images
• npm run test:pages
• npm run test:mermaid

ライセンスと使用

このプロジェクトは MIT License のもとで公開されています。

実際には、MIT License により次のことが許可されています。

• 個人利用、社内利用、学術利用、商用利用の場面でこのプロジェクトを使用する
• コードをコピー、変更、統合、公開、配布する
• このプロジェクトを基盤として、プロプライエタリ製品やオープンソース製品を構築する
• 必要な著作権表示とライセンス表示を保持する限り、派生物を提供する

次の点にご留意ください。

• ソフトウェアのコピーまたは実質的な部分には、元の著作権表示と MIT ライセンスのテキストを保持する必要があります
• ソフトウェアは「現状のまま」提供され、いかなる種類の保証もありません
• このプロジェクトをホスト型サービス、デスクトップツール、プラグイン、社内ワークフローに組み込む場合、コンプライアンス、セキュリティレビュー、下流での使用に関する制約への対応は、ご自身の責任となります

全文は LICENSE をご覧ください。

謝辞

コア依存関係とエコシステム

• Model Context Protocol SDK

  • リポジトリ：https://github.com/modelcontextprotocol/servers
  • 役割：MCP サーバープロトコルの統合

• Dolan Miu による docx

  • リポジトリ：https://github.com/dolanmiu/docx
  • 役割：Word 文書を生成するコアエンジン

コミュニティからの着想

• MCP コミュニティとエコシステム全体から着想を得ています

サポート

• イシュー：https://github.com/jackdark425/aigroup-mdtoword-mcp/issues
• ドキュメント：https://github.com/jackdark425/aigroup-mdtoword-mcp/tree/main/docs
• サンプル：https://github.com/jackdark425/aigroup-mdtoword-mcp/tree/main/examples