PDF Extraction MCP Server (Claude Code Fork)

PDF Extraction MCP Server（Claude Code フォーク）

PDF ファイルの内容を抽出する MCP サーバーです。Claude Code CLI へのインストールに関する修正が含まれています。

このフォークには、Claude Code（CLI 版）でサーバーをインストールして実行するための重要な修正が含まれています。

このフォークでの変更点

1. __main__.py を追加 - python -m pdf_extraction でパッケージをモジュールとして実行できるようにします
2. Claude Code 固有の手順 - Claude Code CLI で動作する明確なインストール手順です
3. インストール手順をテスト済み - claude mcp add コマンドで動作することを確認しています

コンポーネント

ツール

このサーバーは、次のツールを実装しています。

• extract-pdf-contents：ローカルの PDF ファイルから内容を抽出します
  • 必須の文字列引数として pdf_path を受け取ります（ローカルファイルのパス）
  • 省略可能な文字列引数として pages を受け取ります（カンマ区切りのページ番号。最後のページを示す -1 のような負のインデックスに対応）
  • PDF のテキスト抽出と、スキャン文書の OCR の両方に対応しています

Claude Code CLI へのインストール

前提条件

• Python 3.11 以降
• pip または conda
• Claude Code CLI がインストールされていること（claude コマンド）

手順 1：クローンしてインストール

# Clone this fork
git clone https://github.com/lh/mcp-pdf-extraction-server.git
cd mcp-pdf-extraction-server

# Install in development mode
pip install -e .

手順 2：インストールされたコマンドを確認

# Check where pdf-extraction was installed
which pdf-extraction
# Example output: /opt/homebrew/Caskroom/miniconda/base/bin/pdf-extraction

手順 3：Claude Code に追加

# Add the server using the full path from above
claude mcp add pdf-extraction /opt/homebrew/Caskroom/miniconda/base/bin/pdf-extraction

# Verify it was added
claude mcp list

手順 4：Claude で使用

# Start a new Claude session
claude

# In Claude, type:
/mcp

# You should see:
# MCP Server Status
# • pdf-extraction: connected

使用例

接続すると、PDF の内容を抽出するよう Claude に依頼できます。

"Can you extract the content from the PDF at /path/to/document.pdf?"

"Extract pages 1-3 and the last page from /path/to/document.pdf"

トラブルシューティング

サーバーに接続できない

1. サーバーを追加した後、新しい Claude セッションを開始したことを確認してください
2. コマンドのパスが正しいことを確認してください：ls -la $(which pdf-extraction)
3. コマンドを直接テストしてください（入力待ちで停止するはずです）：pdf-extraction

モジュールが見つからないエラー

Python のインポートエラーが発生する場合：

1. パッケージをインストールした環境と同じ Python 環境を使用していることを確認してください
2. Python のフルパスを指定してみてください：claude mcp add pdf-extraction /path/to/python -m pdf_extraction

インストールの問題

pip install -e . が失敗する場合：

1. Python 3.11 以降がインストールされていることを確認してください：python --version
2. 新しい仮想環境を作成してみてください：

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -e .
   

Claude Desktop ユーザー向け

このフォークは Claude Code CLI 専用です。Claude Desktop（GUI アプリ）を使用している場合は、インストール手順について元のリポジトリを参照してください。

依存関係

• mcp>=1.2.0
• pypdf2>=3.0.1
• pytesseract>=0.3.10（OCR 対応用）
• Pillow>=10.0.0
• pydantic>=2.10.1,<3.0.0
• pymupdf>=1.24.0

貢献

貢献を歓迎します！このフォークにおける主な変更点は、パッケージをモジュールとして実行できるようにする __main__.py の追加です。

ライセンス

元のリポジトリと同じです。

クレジット

オリジナルのサーバー：[@xraywu] Claude Code 向けの修正：@lh