GuruPDF

GuruPDF MCP — AI エージェントでPDFや100種類以上のファイル形式を変換

Claude、Cursor、VS Code、WindsurfなどのAIエージェントが、PDFの変換、圧縮、結合、分割、編集や、100種類以上のファイル形式（Word、Excel、PowerPoint、JPG、PNG、HEIC、電子書籍など）の相互変換を、お使いのマシン上で実行できる無料の**Model Context Protocol（MCP）サーバー**です。GuruPDFを利用しています。

言語： 英語 · スペイン語 · フランス語 · ドイツ語 · 中国語 · ロシア語 · ウクライナ語 · ポーランド語 · オランダ語 · トルコ語 · チェコ語 · ギリシャ語 · アラビア語

アシスタントに「このPDFを圧縮して」「invoice.docxをPDFにして」「この3つのファイルを結合して」と頼むだけで、お使いのマシン上でファイルを変換できます。

• 🗂️ 126個のツール — PDF ⇄ Word／Excel／PowerPoint、画像、電子書籍、OCR、圧縮、結合、分割、回転、保護、透かしなど。
• 💻 ローカルファイルで動作 — ディスク上のファイルを読み書きするため、手動でのアップロードやダウンロードは不要です。
• 🆓 無料で始められます — すべてのアカウントで毎日のクレジットを利用できます。クレジットカードは不要です。

インストール

Node.js 18+と無料のGuruPDF APIキーが必要です。

1. **gurupdf.com**で登録します。
2. **プロフィール → APIトークン**を開き、トークンを作成します。
3. そのキーを使って、エージェントにサーバーを追加します（以下の設定を参照）。インストール手順はありません。初回実行時にnpxが取得します。

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your_token_here" }
    }
  }
}

Cursor

~/.cursor/mcp.json（またはプロジェクト内の.cursor/mcp.json）：

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your_token_here" }
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your_token_here" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your_token_here" }
    }
  }
}

ツール

ツール	機能
convert_file	ローカルファイル（またはURL）を変換／処理します。入力と出力形式（pdf、png、docxなど）、またはツールのスラッグ（compress-pdf、merge-pdfなど）を指定します。結果はディスクに保存されます。
get_status	IDで変換ジョブを確認し、完了したら結果をダウンロードします（動画など、時間のかかるジョブ向け）。
list_conversions	対応する変換／ツールの一覧を表示します。入力形式による絞り込みも可能です。
check_credits	残りのクレジット数と追加方法を表示します。

使用例

「~/Documents/report.pdfを圧縮して。」 → convert_file(input: "~/Documents/report.pdf", to: "compress-pdf")

「invoice.docxをPDFに変換して。」 → convert_file(input: "invoice.docx", to: "pdf")

「a.pdfとb.pdfを1つに結合して。」 → convert_file(input: ["a.pdf", "b.pdf"], to: "merge-pdf")

「このPDFをhunter2でパスワード保護して。」 → convert_file(input: "secret.pdf", to: "protect-pdf", options: { password: "hunter2" })

「このウェブページをPDFとして保存して：https://example.com」 → convert_file(input: "https://example.com", to: "url-to-pdf")

無料プランとクレジット

各ツールの利用には数クレジットが必要です。無料アカウントでは毎日のクレジット（毎日補充）を利用でき、1分あたり2回、1日あたり10回変換できます。クレジットがなくなるとアシスタントが知らせます。毎日の補充を待つか、クレジットを追加／アップグレードできます。変換はGuruPDFのサーバー上で実行され、ファイルは1時間以内に自動削除されます。

設定

環境変数	デフォルト	備考
GURUPDF_API_KEY	—	必須です。 プロフィール → API トークンから取得した API トークンを指定します。
GURUPDF_API_URL	https://gurupdf.com/api/v1	セルフホスト環境またはステージング環境の場合のみ、上書きします。

リンク

• Glama：Glama の gurupdf-mcp

• ランディングページ：gurupdf.com/mcp
• ガイド：GuruPDF MCP を使って Claude と Cursor でファイルを変換する
• ウェブサイト：gurupdf.com
• API ドキュメント：gurupdf.com/api/docs
• 料金：gurupdf.com/pricing

ライセンス

MIT