Generate Pdf And Word

ドキュメント生成 MCP

Claude Desktop、Amazon Q Developer、Cline、Continue など、MCP に対応するあらゆる AI エージェントから、プロフェッショナルな Word（.docx）および PDF ドキュメントを生成する MCP（Model Context Protocol）サーバーです。

🚀 機能

• ✅ Word ドキュメント（.docx）を生成
• ✅ PDF ドキュメントを生成
• ✅ JSON ブロックを自動検出（バッククォートは不要です！）🆕
• ✅ プロフェッショナルなシンタックスハイライト（VS Code Dark テーマ）
• ✅ スマートなページ割り（ページ間でコンテンツが分断されません）
• ✅ 100% レスポンシブな書式設定（A4 の余白に対応）
• ✅ Markdown に対応（見出し、リスト、太字、斜体、コードブロック）
• ✅ プロフェッショナルな書式を自動設定
• ✅ メタデータ（作成者、作成日）

📦 インストール

NPX 経由（推奨）

npx document-generator-mcp@latest

NPM グローバル経由

npm install -g document-generator-mcp

⚙️ 設定

Claude Desktop

1. 設定ファイルを探します。

   • Linux: ~/.config/claude-desktop/claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 次の設定を追加します。

{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}

3. Claude Desktop を再起動します。

Amazon Q Developer

1. Amazon Q 拡張機能がインストールされた VS Code を開きます。
2. Amazon Q の設定を開きます。
3. MCP サーバーを追加します。

{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}

その他の MCP エージェント（Cline、Continue など）

MCP に対応するその他のエージェントでは、サーバー設定を追加します。

{
  "name": "document-generator",
  "command": "npx",
  "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
}

設定の詳細については、お使いのエージェントのドキュメントを確認してください。

🎯 使い方

設定後は、任意の MCP エージェントで自然なコマンドを使用できます。

プロンプトの例

• 「売上分析についての Word ドキュメントを作成して」
• 「プロジェクトについての PDF レポートを生成して」
• 「Word と PDF で技術マニュアルを作成して」
• 「Word 形式で API ドキュメントを作成して」
• 「この JavaScript コードを例付きでドキュメント化して」

利用可能なツール

• gerar_documento_word：Word ドキュメント、PDF、またはその両方を作成します
• gerar_documento_pdf：PDF ドキュメントのみを作成します

📝 対応する書式設定

MCP は次の書式を自動的に処理します。

Markdown

• # Heading 1 → 見出し 1（20pt）
• ## Heading 2 → 見出し 2（16pt、青）
• ### Heading 3 → 見出し 3（14pt）
• #### Heading 4 → 見出し 4（12pt）
• - Item → 箇条書き
• 1. Item → 番号付きリスト
• **text** → 太字
• *text* → 斜体
• ***text*** → 太字＋斜体
• `code` → インラインコード
• > quote → 引用
• --- → 水平線

コードブロック

```javascript
async function example() {
  const data = await fetch('api.com');
  return data.json();
}
```

自動検出される JSON（v1.0.9 の新機能！）

JSON オブジェクトと配列は自動的に検出され、コードブロックとして書式設定されます。

{
  "status": "success",
  "data": {
    "users": [
      {"id": 1, "name": "John"}
    ]
  }
}

**シンタックスハイライトの色（VS Code Dark テーマ）：**
- 🟣 キーワード：`async`、`function`、`const`、`await` など（#C586C0）
- 🟠 文字列：`"text"`、`'text'`（#CE9178）
- 🟢 コメント：`// comment`、`/* block */`（#6A9955）
- 🟢 数値：`42`、`3.14`、`0xFF`（#B5CEA8）
- 🟡 関数：`fetch`、`console.log`（#DCDCAA）
- 🔵 型／クラス：`Promise`、`Array`（#4EC9B0）

## 🎨 主な機能

### プロフェッショナルなシンタックスハイライト
- コードブロックにダーク背景（#1E1E1E）を使用
- VS Code Dark テーマの色を使用
- 言語を示すヘッダー
- 行を自動折り返し

### スマートなページ割り
- コードブロックはページ間で分割されません
- 見出しは後続のコンテンツと同じページに配置されます
- 必要に応じてページ区切りを自動挿入
- 一貫した間隔

### レスポンシブな書式設定
- すべてのコンテンツが A4 の余白に収まります
- 長いテキストは自動的に改行されます
- すべての要素の幅を適切に制御
- コンテンツがはみ出しません

## 🧪 テスト

動作を確認するには、次を実行します。

```bash
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx document-generator-mcp@latest

期待される出力：利用可能なツールの一覧（gerar_documento_word、gerar_documento_pdf）

🔧 トラブルシューティング

エラー「use strict: not found」

このエラーが表示される場合、npm が古いキャッシュ版を使用しています。次の方法をお試しください。

1. 次の最適化された設定を使用します。

{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}

2. または、キャッシュをクリアします。

npm cache clean --force
rm -rf ~/.npm/_npx

ドキュメントが生成されない場合

• generated_documents/ フォルダーが存在するか確認してください
• Node.js のバージョンを確認してください（18 以降が必要です）
• エージェントで MCP サーバーのログを確認してください

📁 生成されたファイル

ドキュメントは ./generated_documents/ に一意のタイムスタンプ付きで保存されます。

例：api_documentation_1759715959772.docx

🤖 対応エージェント

この MCP は、Model Context Protocol を実装するすべてのエージェントで動作します。

• ✅ Claude Desktop - ネイティブで完全にサポート
• ✅ Amazon Q Developer - VS Code 経由でサポート
• ✅ Cline (VS Code) - VS Code 拡張機能
• ✅ Continue - MCP 対応のコーディングアシスタント
• ✅ その他の MCP エージェント - 互換性のある実装すべて

🤝 コントリビューション

コントリビューションを歓迎します！GitHub でイシューを作成するか、プルリクエストを送ってください。

開発環境のセットアップ

git clone https://github.com/thiagotw10/document-generator-mcp.git
cd document-generator-mcp
npm install
npm run build

📄 ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください。

🔗 リンク

• NPM パッケージ： https://www.npmjs.com/package/document-generator-mcp
• GitHub リポジトリ： https://github.com/thiagotw10/document-generator-mcp
• MCP ドキュメント： https://modelcontextprotocol.io
• Amazon Q MCP ガイド： https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/qdev-mcp.html

⚠️ 要件

• Node.js： 18 以降が必要です
• プラットフォーム： Linux、macOS、Windows
• MCP サポート： Model Context Protocol を実装するすべてのエージェント

📊 変更履歴

v1.0.9（最新）

• ✅ JSON ブロックを自動検出 - JSON をバッククォート ``` で囲む必要はありません
• ✅ JSON オブジェクトと配列をコードブロックとして自動的にフォーマット
• ✅ フォーマット前に JSON 構文を検証
• ✅ 検出した JSON に構文ハイライトを適用
• ✅ Word と PDF の両方のドキュメントで動作

v1.0.8

• ✅ 国際的な読者向けの英語ドキュメント
• ✅ README の構成を改善

v1.0.7

• ✅ PDF でのプロフェッショナルな構文ハイライト（VS Code Dark テーマ）
• ✅ 100% レスポンシブなフォーマット（A4 の余白に対応）
• ✅ スマートなページ割り（コンテンツの切り取りなし）
• ✅ コードブロック後の余白を改善
• ✅ Word と PDF の視覚的な統一性

---

❤️ Thiago Oliveira が心を込めて制作

AI を使って自然言語をプロフェッショナルなドキュメントに変換しましょう！