MCP Server Doccreator

🚀 MCP サーバー（MCP プロトコルに準拠）

このサーバーは現在、Model Context Protocol (MCP) 標準に準拠した MCP サーバーです。MCP プロトコルを通じてドキュメント生成機能を公開し、AI ホスト（Copilot、Cursor、Claude Desktop など）との統合を可能にします。

✨ 主な機能

MCP 機能

• MCP ツール：generateDocument — プロンプトから PDF、DOCX、PPTX、または XLSX ファイルを生成します。
• 伝送層：標準入出力（ローカル、デフォルト）。必要に応じて、サーバー送信イベント（SSE）を追加してネットワーク通信をサポートできます。
• スキーマ検証：zod を使用して入力検証を行います。
• 拡張性：さらなるツール、リソース、またはプロンプトを簡単に追加できます。

特性

• ドキュメント生成：AI 駆動のプロンプトから PDF、Word、PowerPoint、および Excel ファイルを生成します。
• 画像の埋め込みと拡大縮小：DOCX および PPTX ファイルに画像を挿入し、サイズを調整します。
• 非同期処理：BullMQ と Redis を使用してドキュメント生成タスクをキューに入れ、処理します。
• 検証：スクリーンショットをキャプチャして分析することで、ドキュメントのレイアウトを検証します。
• API ファースト：ドキュメント生成、タスク状態の確認、および結果のダウンロードのための RESTful エンドポイントを提供します。
• 拡張性：新しいファイルタイプやツールを簡単に追加できるモジュール化されたアーキテクチャです。

🔧 技術詳細

プロジェクト構造

src/
  app.js
  server.js
  config/
  controllers/
  middleware/
  public/
  routes/
  services/
  utils/
  workers/
temp_image/
validation-screenshots/
test-output/

🚀 クイックスタート

前提条件

• Node.js（推奨バージョン v14+）
• Redis サーバー

📦 インストール

1. リポジトリをクローンします：

   git clone <repository-url>
   cd mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. 環境変数を設定します：
   • .env.example を .env にコピーし、必要な値を入力します。

サーバーの起動

npm start

テストの実行

npx jest src/services/fileCreation.test.js --runInBand

📚 ドキュメント

API エンドポイント

• POST /documents/generate — ドキュメント生成をリクエストします（PDF、DOCX、PPTX、XLSX）
• GET /documents/generate/status/:jobId — タスクの状態を確認します。
• GET /documents/generate/result/:jobId — 生成されたファイルをダウンロードします。

ファイル生成と検証

• Gemini/OpenAI 関数呼び出しを通じて、AI 駆動のコンテンツとレイアウトをサポートします。
• DOCX および PPTX で画像の挿入と拡大縮小をサポートします。
• レイアウト検証は、スクリーンショットのキャプチャと分析によって行われます（aiFileValidationService を参照）。

💻 使用例

基本的な使用法

npm run build
npm start

MCP ホストの設定例（stdio）

ホストの mcp.json に以下を追加します：

{
  "servers": {
    "your-server-name": {
      "type": "stdio",
      "command": "node",
      "args": ["server.js"]
    }
  }
}

接続の検証

以下のコマンドを実行して、MCP サーバーとの接続を検証します：

mcp ls
mcp info your-server-name

注意事項

⚠️ 重要提示

• Redis サーバーが正しくインストールされ、実行されていることを確認してください。
• 本番環境では、API エンドポイントを保護するために HTTPS を使用し、認証を有効にすることをお勧めします。
• 大規模なタスク処理の場合は、必要に応じて BullMQ と Redis のパフォーマンスパラメータを最適化してください。

以上の手順に従うことで、MCP プロトコルに準拠したドキュメント生成サーバーを簡単に設定し、実行し、さまざまな AI ホストと統合できます。