Auto Snap Mcp

Auto-Snap MCP 📸

MCP クライアント向けのスクリーンショット撮影とドキュメント処理の自動化

スクリーンショットを自動で PDF に変換できます！Auto-Snap を使えば、簡単な自然言語のコマンドで、MCP クライアントからウィンドウをキャプチャし、ドキュメントを処理して PDF を作成できます。

🚀 クイックスタート

どの方法を選べばよいですか？

• 🐳 Docker → セットアップ不要で、どこでも動作します（推奨）
• 🪟 WSL2 → WSL2 をインストール済みの Windows ユーザー向け
• 🐧 Linux → Linux ネイティブ

セットアップ手順

1. Auto-Snap を入手します：

git clone https://github.com/your-repo/auto-snap-mcp
cd auto-snap-mcp

2. 依存関係をインストールします（Linux のみ）：

# Skip this step if using Docker
sudo apt install -y wmctrl xdotool tesseract-ocr
uv sync

3. Claude Desktop を設定します：

~/.claude/claude_desktop_config.json を編集し、以下のいずれか1つを追加します：

🐳 Docker（推奨 — セットアップ不要！）

{
  "mcpServers": {
    "auto-snap-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "DISPLAY=:0", 
        "-v", "/tmp/.X11-unix:/tmp/.X11-unix:rw",
        "-v", "${HOME}/auto-snap-captures:/app/captures:rw",
        "mcp/auto-snap-mcp:latest"
      ]
    }
  }
}

🪟 WSL2（WSL2 を使用する Windows）

{
  "mcpServers": {
    "auto-snap-mcp": {
      "command": "wsl.exe",
      "args": [
        "bash", "-c",
        "cd /home/YOUR_WSL_USERNAME/auto-snap-mcp && DISPLAY=:0 /home/YOUR_WSL_USERNAME/.local/bin/uv run python server.py"
      ]
    }
  }
}

🐧 Linux ネイティブ

{
  "mcpServers": {
    "auto-snap-mcp": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/home/YOUR_USERNAME/auto-snap-mcp",
      "env": {"DISPLAY": ":0"}
    }
  }
}

4. Claude Desktop を再起動して、動作を確認します：

• 「開いているウィンドウをすべて一覧表示して」 ← 接続テストとして、まずこれを試してください
• 「この PDF をキャプチャして画像に変換して」
• 「スクリーンショットを 5 枚撮って、PDF にまとめて」

✅ 動作していますか？ ウィンドウの一覧が表示されるはずです。表示されない場合は、以下の🚨 動作しない場合セクションを確認してください。

📁 ファイルの保存先

デフォルトでは、キャプチャしたファイルはすべて次の場所に保存されます：

~/auto-snap-captures/

パスの例：

• Linux：/home/username/auto-snap-captures/
• WSL2：/home/username/auto-snap-captures/
• Windows（Docker）：C:\Users\username\auto-snap-captures\

✨ できることと試せるコマンド

📋 ドキュメントのキャプチャ

• 任意のウィンドウまたは画面全体のスクリーンショットを撮影
• 複数ページのドキュメントを自動的にキャプチャ
• PDF、プレゼンテーション、ウェブページに対応

🔍 画像処理

• スクリーンショットからテキストを抽出（OCR）
• 画像の品質を自動的に向上
• 複数の画像を一度に処理

📄 PDF の作成

• スクリーンショットをすぐに PDF に変換
• わかりやすい命名規則でファイルを整理
• PDF を圧縮してファイルサイズを削減

🎯 試せるコマンド

「このドキュメントを PDF としてキャプチャして」 → スクリーンショットを撮影して PDF を作成します

「これらの画像からテキストを抽出して」 → スクリーンショットに OCR を実行します

「このプレゼンテーションをアーカイブして」 → すべてのスライドをスクリーンショットにして、1 つの PDF にまとめます

「開いているウィンドウをすべて一覧表示して」 → キャプチャできるものを確認できます

「スクリーンショットを 5 枚撮って、PDF にまとめて」 → 複数ページをキャプチャします

💡 活用のヒント：

• 具体的に指示する：「Chrome ウィンドウをキャプチャして」 のほうが、「スクリーンショットを撮って」 より効果的です
• 複数の手順を指示する：「このプレゼンテーションをスクリーンショットにして、すべてのテキストを抽出して」
• まとめて処理する：「Downloads 内の画像をすべて処理して、PDF を作成して」

ファイルの保存先を変更するには、以下の🎨 キャプチャのカスタマイズセクションを確認してください。

🛠️ システムサポート

• ✅ Linux（ネイティブ X11）
• ✅ WSL2（Linux から Windows アプリを使用）
• ⚠️ macOS（XQuartz が必要 — 実験的）

🚨 動作しない場合

よくある解決方法：

# Check dependencies
uv run python -c "from capture import check_dependencies; print(check_dependencies())"

# Fix X11 display
export DISPLAY=:0

# Test the server
uv run python server.py

まだ解決しませんか？

1. 設定ファイルのパスが正しいことを確認します：~/.claude/claude_desktop_config.json
2. 設定を変更した後、Claude Desktop を再起動します
3. Claude Desktop のログでエラーを確認します

🎨 キャプチャのカスタマイズ

ファイルの保存先を設定する：

export AUTO_SNAP_OUTPUT_DIR="$HOME/Documents/Screenshots"

日付ごとに整理する：

export AUTO_SNAP_USE_DATE_SUBDIRS=true
export AUTO_SNAP_INCLUDE_TIMESTAMP=true

ファイル名をカスタマイズする：

export AUTO_SNAP_FILE_NAME_TEMPLATE="doc_{page:04d}"

🌍 複数の言語

OCR の言語を追加する：

sudo apt install tesseract-ocr-spa  # Spanish
sudo apt install tesseract-ocr-fra  # French
sudo apt install tesseract-ocr-deu  # German

その後、Claude に次のように伝えます：「このドキュメントをスペイン語で処理して」

🔐 プライバシー

• すべての処理はお使いのマシン上でローカルに実行されます
• クラウドサービスへの接続やアップロードはありません
• 指示したものだけをキャプチャします
• 一時ファイルは自動的にクリーンアップされます

---

スクリーンショットの自動化を始めませんか？ Auto-Snap をインストールして、ドキュメントについて MCP クライアントに話しかけてみましょう！ 🚀