📚 PDF MCP Server

Claude Codeで技術書PDFを簡単にダウンロード・管理できるツール

「Pythonの本を探して」と話すだけで、DRMフリーの技術書を検索・ダウンロードできます。NotebookLMとの連携も可能！

🎯 このツールでできること

| 機能 | 説明 | 使い方 | |------|------|--------| | 🔍 PDF検索（NEW!） | キーワードで無料技術書を検索 | 「Pythonの本を探して」 | | 📥 PDFダウンロード | URLから技術書PDFを自動ダウンロード | 「Pro GitのPDFをダウンロードして」 | | 📋 一覧表示 | 管理中のPDFを美しい表形式で表示 | 「PDFの一覧を見せて」 | | 📝 テキスト抽出 | PDFから本文テキストを抽出 | 「このPDFからテキスト抽出して」 | | ☁️ Google Drive連携 | NotebookLM用に自動アップロード | 「このPDFをDriveにアップロード」 |

✨ 使用例

PDFを検索してダウンロード

あなた: 「Pythonの本を探して」

Claude: 🔍 「Python」の検索結果: 2件のPDFが見つかりました

1. 📚 Think Python
   📎 URL: https://greenteapress.com/thinkpython2/thinkpython2.pdf
   📝 説明: Allen B. Downey著。Python初心者向けの入門書
   🏷️  提供元: Green Tea Press

2. 📚 Python Data Science Handbook
   📎 URL: https://github.com/jakevdp/...
   📝 説明: Jake VanderPlas著。NumPy、Pandas、Matplotlibの完全ガイド
   🏷️  提供元: GitHub

💡 ダウンロードするには:
   「1番目のPDFをダウンロードして」と言うか、
   「Think Pythonをダウンロードして」と言ってください。

あなた: 「1番目のPDFをダウンロードして」

Claude: ✅ Think Python.pdfをダウンロードしました
📁 保存場所: ~/.pdf-mcp-server/pdfs/Think_Python.pdf
📊 ファイルサイズ: 2.9 MB

検索できる技術

プログラミング言語: Python, JavaScript, Rust, Go, Java
バージョン管理: Git
コンテナ: Docker, Kubernetes
OS: Linux
データサイエンス: 機械学習、統計、データ分析

🚀 セットアップ（3ステップ）

ステップ1: インストール

git clone https://github.com/tacyan/pdf-mcp-server.git
cd pdf-mcp-server
cargo build --release

Rustがない場合:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

ステップ2: Claude Desktopに登録

macOS:

open ~/Library/Application\ Support/Claude/

Windows:

%APPDATA%\Claude\claude_desktop_config.json

設定内容:

{
  "mcpServers": {
    "pdf-manager": {
      "command": "/YOUR_PATH/pdf-mcp-server/target/release/pdf-mcp-server",
      "args": [],
      "env": {}
    }
  }
}

⚠️ /YOUR_PATH/を実際のパスに置き換えてください

ステップ3: Claude Desktopを再起動

設定を反映させるために、Claude Desktopを再起動してください。

🧩 Cursor / Codex でも使う

pdf-mcp-server には、各クライアント向けの設定スニペットを自動生成する config サブコマンドを追加しています。初心者でも迷わないように、次の順番で作業すれば確実に導入できます。

手順1: 実行ファイルのパスを確認する

リポジトリ直下で pwd（macOS/Linux）または Get-Location（Windows PowerShell）を実行して、プロジェクトの絶対パスを控えます。
ls target/release/pdf-mcp-server / Test-Path .\target\release\pdf-mcp-server.exe でバイナリが存在するかチェックし、なければ cargo build --release を再実行します。
target/release/pdf-mcp-server --help もしくは ./target/release/pdf-mcp-server.exe --help で動作確認しておくと安心です。

手順2: テンプレートを生成する

macOS / Linux: target/release/pdf-mcp-server config <client>
Windows PowerShell: ./target/release/pdf-mcp-server.exe config <client>
<client> には cursor / codex / claude-desktop を指定します。出力には絶対パス入りのテンプレートと、具体的な作業手順が日本語で表示されます。
必要であれば --output <ファイルパス> と --force を併用してテンプレートをファイルに書き出したり、--apply-default で既定パスへ直接書き込むこともできます。

手順3: 各クライアントに反映する

Claude Desktop: claude_desktop_config.json を編集し、mcpServers に "pdf-manager" ブロックを追加 → アプリを再起動。
Cursor: target/release/pdf-mcp-server config cursor --apply-default（初回）またはコマンドパレットで Open mcp.json を開き、mcpServers に "pdf-manager" ブロックを追加 → Reload MCP Servers を実行または再起動。
Codex (CLI/IDE): codex config edit または ~/.codex/config.toml を開き、[mcp_servers.pdf_manager] ブロックを追記 → codex mcp list で認識を確認。

こうしておけば、Claude Desktop 以外の環境でも同じ MCP サーバー定義を安全に共有できます。テンプレートは常に最新の実行パスで生成されるため、マシンを移動した場合でも config コマンドをもう一度実行するだけで再設定可能です。

💡 よくある質問

Q: どんなPDFがダウンロードできますか？

A: DRMフリー（コピープロテクトがない）のPDFのみです：

✅ ダウンロード可能

オープンソース技術書（Pro Git、The Rust Bookなど）
Creative Commonsライセンス書籍
著者が無料公開している本
購入したDRMフリーPDF

❌ ダウンロード不可

Kindle等のDRM保護ファイル
違法コピーされたファイル

Q: NotebookLMとの連携方法は？

A: 以下の手順で連携できます：

PDFをダウンロード
「このPDFをGoogle Driveにアップロードして」と言う
NotebookLMを開く
「ソースを追加」→「Google Drive」からPDFを選択

Q: PDFはどこに保存されますか？

A: ~/.pdf-mcp-server/pdfs/に保存されます（macOS/Linux）

Windowsの場合: %USERPROFILE%\.pdf-mcp-server\pdfs\

🔧 Google Drive連携（オプション）

Google Driveへのアップロード機能を使う場合は、追加設定が必要です。

詳しくは CONFIG_GUIDE.md を参照してください。

📖 詳細ドキュメント

| ドキュメント | 内容 | |------------|------| | EXAMPLES.md | 💡 実践的な使い方・ユースケース集 | | CONFIG_GUIDE.md | 🔧 Google Drive設定ガイド | | CONTRIBUTING.md | 🤝 プロジェクトへの貢献方法 |

🌟 人気の無料技術書

このツールで検索・ダウンロードできる人気の技術書：

プログラミング言語

Pro Git - Gitの完全ガイド
Think Python - Python入門書
Eloquent JavaScript - JavaScript完全ガイド
The Rust Programming Language - Rust公式ブック

データサイエンス

Python Data Science Handbook - NumPy、Pandas完全ガイド
Introduction to Statistical Learning - 統計的学習の基礎

インフラ

The Linux Command Line - Linuxコマンド完全ガイド
Docker Deep Dive - Docker実践ガイド

📝 ライセンス

MIT License

🤝 貢献

プルリクエスト、Issue、機能リクエストを歓迎します！

詳しくは CONTRIBUTING.md をご覧ください。

💡 「Pythonの本を探して」と話すだけで、技術書の検索・ダウンロードが始まります！

MCP Servers