Screenshot

🚀 スクリーンショットサーバー（ファイルパスフォーカス）

このプロジェクトは、MCP（モジュール化通信プロトコル）サーバーを提供します。このサーバーは、スクリーンショットをキャプチャし、それを他のプロセスやAIアシスタントで使用できるようにすることを目的としており、主にクライアント（ホスト）が指定したファイルパスにスクリーンショットを保存することで実現されます。

🚀 クイックスタート

✨ 主な機能

AIアシスタントがMCPを介して送信するスクリーンショットの画像データを直接解釈することは、テストでは信頼性が低いことが判明しました。このサーバーは、より信頼性の高いファイルパスベースのワークフローを採用しています。

推奨ワークフロー（WSLホスト -> Windowsサーバー）：

1. MCPホスト（例えばWSLで動作するAIアシスタント）がsave_screenshot_to_host_workspaceツールを呼び出し、WSLワークスペースパスをパラメータとして渡します。
2. Windows上で動作するサーバーがスクリーンをキャプチャします。
3. サーバーは受け取ったWSLパスをWindowsでアクセス可能なUNCパス（例：\\wsl$\Distro\path）に変換します。
4. サーバーはUNCパスを介して、ホストのWSLファイルシステム内の指定された場所にスクリーンショットを保存します。
5. サーバーは"success"または"failed:... "を返します。
6. MCPホストは、スクリーンショットがワークスペース（パラメータでサブディレクトリが指定されている場合は指定されたサブディレクトリ）に保存されたことを知ります。
7. MCPホストは、WSLパスを別の専用MCPサーバー（WSLで動作）に渡して画像分析を行うことができます。

汎用代替ワークフロー：

1. MCPホストがtake_screenshot_and_return_pathを呼び出し、オプションでファイル名を指定します。
2. サーバーはスクリーンショットをローカルのimages/ディレクトリに保存します。
3. サーバーはファイルパスを返します。
4. MCPホストは返されたパスに基づいてスクリーンショットを処理することができます。

📦 インストール

• Windows上にPythonをインストールし、uvを使用してプロジェクトの依存関係をインストールします：uv sync .
• MCPホストの設定を更新してこのサーバーを起動します：

{
    "mcpServers": {
        "Screenshot-server": {
            "command": "powershell.exe",
            "args": [
                "-Command",
                "cd '<YOUR_WINDOWS_PROJECT_PATH>'; & '<YOUR_WINDOWS_UV_PATH>' run screenshot.py"
            ]
        }
        // ... 他のサーバー ...
    }
}

💻 使用例

基本的な使用法

1. WSL内で、AIアシスタントが現在のワークスペースパス（例：/home/user/current_project）を取得します。
2. AIアシスタントがuse_mcp_toolを使用してsave_screenshot_to_host_workspaceをScreenshot-serverに呼び出し、host_workspace_path="/home/user/current_project"とオプションのnameパラメータを渡します。
3. "success"応答を受け取ります。
4. AIアシスタントは、スクリーンショットが/home/user/current_project/workspace_screenshot.jpg（または指定されたファイル名）に保存されたことを知ります。
5. AIアシスタントがuse_mcp_toolを使用してWSLで動作する画像分析サーバー/ツールを呼び出し、WSLパス/home/user/current_project/workspace_screenshot.jpgを渡します。
6. 画像分析サーバーがファイルを読み取り、そのタスクを実行します。

📚 ドキュメント

ツール

• save_screenshot_to_host_workspace：ホストのWSLワークスペースパスにスクリーンショットを保存します。
• take_screenshot_and_return_path：スクリーンショットのファイルパスを返します。
• capture_screen：現在のスクリーンをキャプチャし、Base64エンコードされた画像データを返します。

ファイル構造

• screenshot.py：核心的なMCPサーバースクリプトです。
• README.md：このドキュメントファイルです。
• pyproject.toml：uv用のプロジェクト定義と依存関係です。
• uv.lock：依存関係のロックファイルです。
• .gitignore：Gitの無視設定です。
• .python-version：（オプション）Pythonのバージョン指定ファイルです。
• server.log：サーバーが生成するログファイルです。
• images/：take_screenshot_and_return_pathのデフォルトディレクトリです。