Aigroup Mdtoword MCP

🚀 AI Group Markdown to Word MCP Server

このサーバーは、高度な書式設定、スタイリング、レイアウト機能を備えた、MarkdownドキュメントをプロフェッショナルなWordドキュメントに変換するための包括的なModel Context Protocol (MCP)サーバーです。

✨ 主な機能

コア変換機能

• 完全なMarkdownサポート：見出し、段落、リスト、テーブル、コードブロック、ブロック引用を含むすべてのMarkdown構文をサポートします。
• 高度なスタイリングシステム：テーマ、テンプレート、カスタムスタイリングを含む包括的なスタイル設定が可能です。
• プロフェッショナルなドキュメントレイアウト：ページ設定、余白、向き、ドキュメント構造を調整できます。

高度な機能

• 数式サポート：LaTeX数式をインラインおよびブロックでレンダリングできます。
• テーブル処理：12種類以上の事前設定されたスタイルを持つ高度なテーブルスタイリング、CSV/JSONデータのインポートが可能です。
• 画像サポート：ローカルおよびリモートの画像を自動的にスケーリングし、整形して埋め込むことができます。
• ヘッダーとフッター：ページ番号、総ページ数、カスタムコンテンツを含む完全なヘッダー/フッターシステムが用意されています。
• 目次：レベルとスタイルを設定可能な自動目次生成機能があります。
• 透かし：位置、回転、透明度を設定可能なテキスト透かしを追加できます。

MCP統合

• 複数のトランスポート方式：STDIOとStreamable HTTPトランスポートをサポートしています。
• ツールベースのインターフェイス：ドキュメント変換用のクリーンなMCPツールインターフェイスが提供されています。
• リソーステンプレート：様々なユースケースに対応した事前構築済みのドキュメントテンプレートがあります。
• プロンプトシステム：ユーザーガイダンスとトラブルシューティングのためのインテリジェントなプロンプトが用意されています。

🚀 クイックスタート

インストール

# 一度だけの使用に推奨
npx -y aigroup-mdtoword-mcp

# またはグローバルにインストール
npm install -g aigroup-mdtoword-mcp

Claude Desktopでの使用方法

Claude Desktopの設定ファイル (claude_desktop_config.json) に以下を追加します。

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

その他のMCPクライアントでの使用方法

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

💻 使用例

基本的な使用法

# インストールコマンド
npx -y aigroup-mdtoword-mcp

高度な使用法

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

🛠️ 利用可能なツール

markdown_to_docx

完全なスタイリングをサポートしたMarkdownコンテンツをWordドキュメントに変換します。

入力スキーマ:

{
  markdown?: string;           // Markdownコンテンツ (inputPathが指定されていない場合必須)
  inputPath?: string;          // Markdownファイルのパス
  filename: string;            // 出力ファイル名 (拡張子なし)
  outputPath?: string;         // カスタム出力ディレクトリ
  styleConfig?: StyleConfig;   // 高度なスタイル設定
}

使用例:

このMarkdownをWordドキュメントに変換します。

# プロジェクトレポート
## エグゼクティブサマリー
これは**太字**と*斜体*を含むサンプルレポートです。

- 機能1: 完全なMarkdownサポート
- 機能2: 高度なスタイリングシステム
- 機能3: プロフェッショナルなドキュメントレイアウト

| 列1 | 列2 | 列3 |
|------|------|------|
| データ1 | データ2 | データ3 |
| データ4 | データ5 | データ6 |

数式: $E = mc^2$

table_data_to_markdown

構造化データ (CSV/JSON) を整形されたMarkdownテーブルに変換します。

入力スキーマ:

{
  data: string;                // CSVまたはJSONデータ
  format: 'csv' | 'json';      // データ形式
  style?: string;              // テーブルスタイルの事前設定
  hasHeader?: boolean;         // データにヘッダーが含まれているかどうか
}

📚 利用可能なリソース

テンプレート

• 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 - メモリ使用量統計

🎨 スタイリングシステム

基本的なスタイリング

{
  document: {
    defaultFont: "宋体",
    defaultSize: 24,
    defaultColor: "000000",
    page: {
      size: "A4",
      orientation: "portrait",
      margins: { top: 1440, bottom: 1440, left: 1440, right: 1440 }
    }
  },
  headingStyles: {
    h1: { font: "黑体", size: 64, color: "000000", bold: true },
    h2: { font: "黑体", size: 32, color: "000000", bold: true }
  }
}

高度な機能

• テーマシステム：一貫したブランディングのための色とフォントの変数が用意されています。
• ヘッダー/フッター：ページ番号を含むカスタムヘッダーとフッターを設定できます。
• 透かし：ドキュメント保護のためのテキスト透かしを追加できます。
• テーブルスタイリング：12種類以上の事前設定されたテーブルスタイルとゼブラ縞模様が用意されています。
• 数式レンダリング：プロフェッショナルな数式レンダリング機能があります。

📊 テーブルスタイル

サーバーには12種類のプロフェッショナルにデザインされたテーブルスタイルが含まれています。

1. minimal - 細い境界線を持つクリーンな現代的なスタイル
2. professional - 暗いヘッダーを持つビジネススタイル
3. striped - 読みやすさを向上させるゼブラ縞模様
4. grid - 構造化データ用の完全なグリッド境界線
5. elegant - 正式なドキュメント用の二重境界線
6. colorful - 鮮やかなプレゼンテーション用のカラフルなヘッダー
7. compact - データが密集したテーブル用の最小限の余白
8. fresh - 環境レポート用のグリーンテーマ
9. tech - 技術文書用のブルーテクノロジーテーマ
10. report - 正式なレポートスタイルの二重境界線
11. financial - 財務データ用の右揃え数字
12. academic - 学術論文スタイル

🔧 設定

スタイル設定

完全なスタイル設定では、以下の項目をサポートしています。

• ドキュメントレベルの設定 (フォント、色、ページ設定)
• 段落と見出しのスタイル
• テーブルとリストの整形
• 画像とコードブロックのスタイリング
• ヘッダー/フッターの設定
• 透かしの設定

トランスポートオプション

• STDIO：ローカル実行用の標準入出力
• Streamable HTTP：リモートサーバー用のHTTPトランスポート

📁 プロジェクト構造

src/
├── index.ts                 # メインのMCPサーバー実装
├── converter/
│   └── markdown.ts         # MarkdownからDOCXへの変換器
├── template/
│   └── presetLoader.ts     # テンプレートシステム
├── types/
│   ├── index.ts           # コアタイプ
│   ├── style.ts          # スタイル設定タイプ
│   └── template.ts       # テンプレートタイプ
└── utils/
    ├── tableProcessor.ts  # テーブル処理ユーティリティ
    ├── mathProcessor.ts   # 数式処理
    ├── imageProcessor.ts  # 画像処理ユーティリティ
    ├── styleEngine.ts     # スタイル適用エンジン
    └── errorHandler.ts    # エラー処理ユーティリティ

🧪 テスト

テストスイートを実行します。

npm test

利用可能なテストシナリオ:

• 数式変換
• ローカル画像の埋め込み
• ページ番号とヘッダー/フッター
• テーブルスタイリングとデータインポート
• 完全なドキュメント変換

🚀 パフォーマンス

• 高速変換：大規模なドキュメントに対して最適化された処理が行われます。
• メモリ効率：ストリームベースの処理により、最小限のメモリ使用量で動作します。
• 本番環境対応：堅牢なエラーハンドリングとロギング機能が備わっています。
• スケーラビリティ：どのようなサイズのドキュメントでも効率的に処理できます。

🤝 コントリビューション

コントリビューションを歓迎します！詳細はContributing Guidelinesをご覧ください。

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. テストを追加する
5. プルリクエストを送信する

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Model Context Protocol SDKを使用して構築されています。
• Wordドキュメント生成にdocxを使用しています。
• MCPコミュニティとエコシステムからインスピレーションを得ています。

📞 サポート

• 問題報告: GitHub Issues
• ドキュメント: 完全なドキュメント
• サンプル: サンプルファイル

AI Group Markdown to Word MCP Server - MCPプロトコルによるプロフェッショナルなドキュメント変換サービス