Pdfgenstudio MCP

🚀 PDF Gen Studio MCP Server

PDF Gen Studio用のモデルコンテキストプロトコル（MCP）サーバーです。テンプレート、JSON、HTML、またはURLからPDFや画像を生成できます。

✨ 主な機能

• 📄 テンプレートレンダリング - 保存されたテンプレートを動的なデータ注入でレンダリングします。
• 🔧 JSONレンダリング - JSON設計ドキュメントをPDF/画像に変換します。
• 🌐 HTMLレンダリング - HTML/CSSコンテンツをPDF/画像に変換します。
• 📸 URLレンダリング - 任意のウェブサイトURLのスクリーンショットをPDF/画像として取得します。
• 📋 テンプレート管理 - 保存されたテンプレートを一覧表示し、取得できます。

📦 インストール

npmを使用する場合（グローバル）

npm install -g @pdfgenstudio/mcp

npxを使用する場合（インストール不要）

npx @pdfgenstudio/mcp

ソースからインストール

git clone https://github.com/Majid9287/pdfgenstudio-mcp.git
cd pdfgenstudio-mcp
npm install
npm run build

Dockerを使用する場合

docker pull mcp/pdfgenstudio:latest

または、ローカルでビルドする場合:

docker build -t mcp/pdfgenstudio .

🔧 設定

環境変数

PDF Gen StudioのAPIキーを設定します。

export PDFGENSTUDIO_API_KEY="your-api-key-here"

Windows（PowerShell）の場合:

$env:PDFGENSTUDIO_API_KEY = "your-api-key-here"

Windows（コマンドプロンプト）の場合:

set PDFGENSTUDIO_API_KEY=your-api-key-here

オプション設定

💻 使用例

stdioサーバーとして（デフォルト）

# グローバルインストールを使用する場合
pdfgenstudio-mcp

# npxを使用する場合
npx @pdfgenstudio/mcp

# 明示的なトランスポートを指定する場合
pdfgenstudio-mcp --transport stdio

HTTPサーバーとして

# ポート3100でHTTPサーバーを起動する場合
pdfgenstudio-mcp --transport http --port 3100

# カスタムポートを使用する場合
pdfgenstudio-mcp -t http -p 8080

開発とテスト

# fastmcp CLIでテストする場合
npm run test

# MCPインスペクターで検査する場合
npm run inspect

🔌 クライアント統合

Claude Desktop

Claude Desktopの設定ファイルに追加します。

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

npxを使用する場合（推奨）

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

ローカルインストールを使用する場合

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "node",
      "args": ["/absolute/path/to/pdfgenstudio-mcp/dist/index.js"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

編集後、Claude Desktopを完全に再起動します。

Docker Desktop (MCP Toolkit)

PDF Gen Studio MCPは、Docker DesktopのMCP Toolkitカタログにあります。

オプション1: Docker Desktop MCP Toolkit UIを使用する場合

1. Docker Desktopを開きます。
2. Extensions → MCP Toolkitに移動します。
3. カタログで "pdfgenstudio" を検索します。
4. Install をクリックし、APIキーを設定します。

オプション2: 手動設定

Claude Desktopの設定にDockerイメージを使用するように追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "PDFGENSTUDIO_API_KEY=your-api-key-here",
        "mcp/pdfgenstudio:latest"
      ]
    }
  }
}

Dockerコンテナを直接実行する場合

# stdioモードで実行（デフォルト） - MCPクライアント統合用
docker run -it --rm \
  -e PDFGENSTUDIO_API_KEY="your-api-key-here" \
  mcp/pdfgenstudio:latest

# HTTPモードで実行 - ローカル開発/テスト用
docker run -it --rm -p 3100:3100 \
  -e PDFGENSTUDIO_API_KEY="your-api-key-here" \
  mcp/pdfgenstudio:latest node dist/index.js --transport http --port 3100

Docker Composeを使用する場合

# APIキーを含む.envファイルを作成する
echo "PDFGENSTUDIO_API_KEY=your-api-key-here" > .env

# stdioモードで実行（デフォルト）
docker-compose up -d pdfgenstudio-mcp

# HTTPモードで実行（ローカルテスト用）
docker-compose --profile http up -d pdfgenstudio-mcp-http

VS Code (GitHub Copilot)

VS Codeは、GitHub Copilot拡張機能を通じてMCPサーバーをサポートしています。

ステップ1: VS CodeでMCPを有効にする

1. VS Codeの設定を開きます（Ctrl+, または Cmd+,）。
2. github.copilot.chat.experimental.mcp を検索します。
3. 設定を有効にします。

ステップ2: MCPサーバーを設定する

ワークスペース内の .vscode/mcp.json を作成または編集します。

{
  "servers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

または、VS Codeのユーザー設定（settings.json）に追加します。

{
  "github.copilot.chat.experimental.mcp": true,
  "mcp": {
    "servers": {
      "pdfgenstudio": {
        "command": "npx",
        "args": ["-y", "@pdfgenstudio/mcp"],
        "env": {
          "PDFGENSTUDIO_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

VS Codeでローカルインストールを使用する場合

{
  "servers": {
    "pdfgenstudio": {
      "command": "node",
      "args": ["C:/path/to/pdfgenstudio-mcp/dist/index.js"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Cursorは組み込みのMCPサポートを持っています。Cursorの設定で構成します。

ステップ1: Cursorの設定を開く

1. Cursorを開きます。
2. Settings → Cursor Settings → MCP に移動します。
3. または、Ctrl+Shift+P / Cmd+Shift+P を押して "MCP" を検索します。

ステップ2: MCPサーバーを追加する

次の構成を追加します。

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

代替方法: 設定ファイルを直接編集する

macOS: ~/.cursor/mcp.json Windows: %USERPROFILE%\.cursor\mcp.json Linux: ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf (Codeium)

Windsurfはその設定を通じてMCPをサポートしています。

設定ファイルの場所

macOS: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json Linux: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Zed Editor

ZedはネイティブでMCPをサポートしています。Zedの設定で構成します。

設定

~/.config/zed/settings.json を編集します。

{
  "language_models": {
    "mcp_servers": {
      "pdfgenstudio": {
        "command": "npx",
        "args": ["-y", "@pdfgenstudio/mcp"],
        "env": {
          "PDFGENSTUDIO_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Continue (VS Code/JetBrains拡張機能)

Continueは、強化されたAI機能のためにMCPサーバーをサポートしています。

設定

~/.continue/config.json を編集します。

{
  "mcpServers": [
    {
      "name": "pdfgenstudio",
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  ]
}

HTTP/SSEモード（カスタムクライアント用）

HTTPベースのMCP接続をサポートするクライアントの場合:

サーバーを起動する

# HTTPサーバーを起動する
npx @pdfgenstudio/mcp --transport http --port 3100

エンドポイント

• HTTPストリーミング: http://localhost:3100/mcp
• SSE: http://localhost:3100/sse
• ヘルスチェック: http://localhost:3100/health

クライアント接続の例

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("http://localhost:3100/mcp")
);

const client = new Client({
  name: "my-client",
  version: "1.0.0",
});

await client.connect(transport);

トラブルシューティング

一般的な問題

1. "API key not configured"
   • PDFGENSTUDIO_API_KEY が env セクションに設定されていることを確認します。
   • 環境変数名のスペルミスを確認します。
2. "Command not found" (npx)
   • Node.js 18+ がインストールされていることを確認します。
   • npxの完全パスを使用してみてください: /usr/local/bin/npx
3. サーバーに接続できない
   • 設定変更後にIDE/アプリケーションを再起動します。
   • ログを確認してエラーメッセージを確認します。
   • ローカルインストールのパスが正しいことを確認します。
4. Windowsのパスの問題
   • パスでは、スラッシュ / またはエスケープされたバックスラッシュ \\ を使用します。
   • 絶対パスを使用します。

デバッグモード

デバッグログを有効にして実行します。

DEBUG=* npx @pdfgenstudio/mcp

インストールを確認する

# サーバーを直接テストする
npx @pdfgenstudio/mcp --help

# MCPインスペクターでテストする
npx fastmcp inspect /path/to/pdfgenstudio-mcp/src/index.ts

利用可能なツール

テンプレートツール

JSONツール

HTMLツール

URLツール

管理ツール

リソース

MCPサーバーは次のリソースを提供します。

プロンプト

一般的なタスク用の事前構築済みプロンプトです。

例の使用方法

テンプレートをレンダリングする

render_templateツールを使用して、テンプレートID "abc123" から次のデータでPDFを生成します: {"name": "John Doe", "amount": "$500"}

ウェブページのスクリーンショットを撮影する

https://example.comの全ページのスクリーンショットをPNGとして取得します。

HTMLレポートを生成する

このHTMLをPDFに変換します:
<html>
  <body>
    <h1>Monthly Report</h1>
    <p>Content here...</p>
  </body>
</html>

📚 詳細ドキュメント

詳細なAPIドキュメントについては、docs.pdfgenstudio.com を訪問してください。

開発

# 依存関係をインストールする
npm install

# ビルドする
npm run build

# ウォッチモードで実行する
npm run dev

# MCP CLIでテストする
npm run test

# MCPインスペクターで検査する
npm run inspect

📄 ライセンス

MITライセンス - 詳細については LICENSE を参照してください。

サポート

• 📚 ドキュメント
• 💬 Discordコミュニティ
• 🐛 問題追跡
• 📧 メールサポート