mcp-pdf

@mcp-z/mcp-pdf

MCP を通じて PDF ドキュメントやレイアウトを作成し、ページを PNG にレンダリングして、テキストを計測します。サーバーはローカルで動作し、API キーは不要です。

Node.js >=22.13 が必要です。例では、npm に含まれる npx を使用して、このサーバーと @mcp-z/cli を実行します。

トランスポート

MCP は stdio と HTTP をサポートしています。

どちらのトランスポートも、2025 および 2026-07-28 のプロトコルリビジョンに対応しています。2026 リビジョンはステートレスのため、これを使用するクライアントは initialize ハンドシェイクもセッション ID も送信しません。

コマンドを実行するディレクトリに、以下のいずれかの設定を .mcp.json として保存してください。

Stdio

{
  "mcpServers": {
    "pdf": {
      "command": "npx",
      "args": ["-y", "@mcp-z/mcp-pdf"]
    }
  }
}

HTTP

{
  "mcpServers": {
    "pdf": {
      "type": "http",
      "url": "http://localhost:9010/mcp",
      "start": {
        "command": "npx",
        "args": ["-y", "@mcp-z/mcp-pdf", "--port=9010"]
      }
    }
  }
}

start は、npx @mcp-z/cli up が HTTP サーバーを起動するために使用する拡張機能です。MCP エンドポイントは /mcp です。

初回の使い方

# List tools
npx -y @mcp-z/cli inspect --servers pdf --tools

# Create a simple PDF
npx -y @mcp-z/cli call-tool pdf pdf-document '{"content":[{"type":"text","text":"Hello from MCP"}]}'

このツールは、生成された PDF のファイル URI とメタデータを返します。パラメーターと使用例については、ツールの完全なリファレンスを参照してください。

ツールの概要

ツール	用途
pdf-document	自動ページ分割に対応した、流し込み形式のドキュメント
pdf-layout	スライドやチラシなど、正確に配置されたレイアウト
pdf-resume	JSON Resume ドキュメント
pdf-image	PDF ページを PNG にレンダリング
text-measure	レイアウト前のテキスト計測

外部リソース

なし。

プロンプト

1. resource-fetching

リソース

• PDFKit ドキュメント
• JSON Resume スキーマ
• JSON Resume エディター

ドキュメント

API ドキュメント