MCP Windows Screenshots

🚀 MCP Windows Screenshots

MCP（Model Context Protocol）サーバーで、WSL2からClaudeがWindowsのスクリーンショットにアクセスできるようにします。手動でファイルを探すことなく、Claude Codeとスクリーンショットをシームレスに共有するのに最適です。

🚀 クイックスタート

WSL2でClaude Codeを使用する際、Windowsのスクリーンショットを共有するには、/mnt/c/Users/... のような複雑なファイルパスを辿る必要があります。このツールを使用することで、以下の手順で簡単にスクリーンショットを共有できます。

1. Windowsでスクリーンショットを撮影する（Win+Shift+S）
2. Claudeに最新のスクリーンショットを表示するように依頼する
3. Claudeがすぐにアクセスして表示する

パスのコピー＆ペーストやディレクトリの移動は不要です！

✨ 主な機能

• WSL2上のClaude CodeでWindowsのスクリーンショットを簡単に共有できる。
• 複雑なファイルパスを辿る必要がなく、Claudeが自動的に最新のスクリーンショットにアクセスする。

📦 インストール

WSL2ターミナルで以下のコマンドを実行してください。

claude mcp add windows-screenshots -s user \
  -e "WINDOWS_USERNAME=YourWindowsUsername" \
  -e "MCP_SCREENSHOT_DIRS=/mnt/c/Users/YourWindowsUsername/Pictures/Screenshots" \
  -- npx mcp-windows-screenshots@latest

YourWindowsUsername を実際のWindowsユーザー名に置き換えてください。

例

Windowsユーザー名が "john" で、スクリーンショットがOneDriveに保存されている場合：

claude mcp add windows-screenshots -s user \
  -e "WINDOWS_USERNAME=john" \
  -e "MCP_SCREENSHOT_DIRS=/mnt/c/Users/john/OneDrive/Pictures/Screenshots" \
  -- npx mcp-windows-screenshots@latest

これで完了です。Claude Codeを再起動すると、使用できるようになります。

💻 使用例

基本的な使用法

Claudeに「最新のスクリーンショットを見て」と依頼すると、Claudeが自動的にそれを見つけて画像を表示します。

高度な使用法

• 最近のスクリーンショットを一覧表示する：Claudeに「最新のスクリーンショットを表示して」と依頼すると、Claudeは mcp__windows-screenshots__list_screenshots を使用して、タイムスタンプとサイズ付きで最近のスクリーンショットを表示します。
• スクリーンショットの検索ディレクトリを確認する：Claudeに「どのディレクトリをスクリーンショットの検索対象にしているか」と依頼すると、Claudeは mcp__windows-screenshots__list_directories を使用して、すべての設定済みパスを表示します。

📚 ドキュメント

環境変数

• WINDOWS_USERNAME：Windowsユーザー名（デフォルトはWSLユーザー名）
• MCP_SCREENSHOT_DIRS：カスタムのスクリーンショットディレクトリ。複数のディレクトリを指定する場合は、セミコロンで区切ってください：/path/1;/path/2

デフォルトの検索場所

このツールは、以下の一般的な場所を自動的に検索します。

• /mnt/c/Users/[username]/Pictures/Screenshots
• /mnt/c/Users/[username]/Pictures
• /mnt/c/Users/[username]/OneDrive/Pictures/Screenshots
• /mnt/c/Users/[username]/OneDrive/Pictures 2/Screenshots 1
• /mnt/c/Users/[username]/Documents/Screenshots
• /mnt/c/Users/[username]/Desktop
• /mnt/c/Users/[username]/AppData/Local/Temp

🔧 技術詳細

スクリーンショットが見つからない場合

1. Windowsユーザー名が正しいことを確認してください。
2. Claudeに「スクリーンショットのディレクトリを一覧表示」と依頼して、どのパスが検索対象になっているかを確認してください。
3. スクリーンショットが検索対象のディレクトリに保存されていることを確認してください。
4. 必要に応じて、MCP_SCREENSHOT_DIRS でカスタムディレクトリを設定してください。

ツールが使用できない場合

1. インストール後にClaude Codeを再起動してください。
2. claude mcp list を実行して、サーバーがインストールされていることを確認してください。
3. サーバーを追加する際に -s user を使用したことを確認してください。

環境変数が機能しない場合

インストールセクションに示されているように、claude mcp add コマンドで -e フラグを使用していることを確認してください。

開発

このツールに貢献したり、変更を加えたりするには、以下のコマンドを実行してください。

git clone https://github.com/rubinsh/mcp-windows-screenshots.git
cd mcp-windows-screenshots
npm install
npm run build

📄 ライセンス

MIT © rubinsh