Winsight MCP

🚀 WinSight MCP

WinSight MCPは、Windowsのデスクトップ画面をClaude Codeに見せることができるWindows Screen Capture MCPサーバーです。このサーバーを通じて、Claude CodeがWindows上で画面キャプチャ、ウィンドウ管理、アプリケーション起動などの操作を行うことが可能になります。

🚀 クイックスタート

オプション1: uvx (推奨)

インストール不要で直接実行できます。

{
  "mcpServers": {
    "winsight": {
      "command": "uvx",
      "args": ["winsight-mcp"]
    }
  }
}

これをプロジェクトの .mcp.json または ~/.claude/claude_desktop_config.json に追加してください。

オプション2: pip install

pip install winsight-mcp

その後、以下のように設定します。

{
  "mcpServers": {
    "winsight": {
      "command": "winsight-mcp"
    }
  }
}

オプション3: ソースからインストール

git clone https://github.com/TheoEwzZer/WinSight-MCP.git
cd WinSight-MCP
uv sync

{
  "mcpServers": {
    "winsight": {
      "command": "uv",
      "args": ["--directory", "/path/to/WinSight-MCP", "run", "winsight-mcp"]
    }
  }
}

✨ 主な機能

• スクリーンショット: 全画面、特定の領域、または特定のウィンドウのスクリーンショットを撮影できます。
• ウィンドウキャプチャ: Win32の PrintWindow API を使用しているため、他のウィンドウの後ろに隠れている場合でも、実際のウィンドウ内容をキャプチャできます。
• ウィンドウとモニターの一覧表示と詳細確認: 開いているウィンドウとモニターの情報（タイトル、位置、サイズ、状態、解像度）を一覧表示し、詳細を確認できます。
• ウィンドウの制御: ウィンドウの移動、サイズ変更、最小化、最大化、復元、フォーカスを制御できます。
• アプリケーションの起動: アプリケーションを起動し、そのウィンドウが表示されるのを待つことができます。

📦 インストール

必要条件

• Windows 10/11
• Python 3.10+

💻 使用例

MCPサーバーが接続されたら、Claude Codeに以下のようなことを依頼できます。

• "画面のスクリーンショットを撮って"
• "開いているすべてのウィンドウを一覧表示して"
• "メモ帳のウィンドウをキャプチャして"
• "電卓を開いて、そのスクリーンショットを撮って"
• "Chromeのウィンドウにフォーカスを当てて"
• "アプリケーションのウィンドウを800x600にリサイズして、スクリーンショットを撮って"
• "ウィンドウを左上隅に移動して"
• "私が持っているモニターは何ですか？"

📚 ドキュメント

スクリーンショット関連ツール

ウィンドウ管理ツール

システム関連ツール

テスト

このプロジェクトには、すべてのモジュールをカバーする112のテストが含まれています。テストではWin32 APIをモック化しているため、どのプラットフォームでも実行できます。

テストの実行

uv run pytest

テスト構造

tests/
  conftest.py              # 共有のフィクスチャとWin32スタブ
  test_types.py            # TypedDict定義の検証
  test_screenshot.py       # 画面/領域/ウィンドウのキャプチャ (mss, Win32 DC)
  test_window_manager.py   # ウィンドウの一覧表示、検索、フォーカス、サイズ変更、移動、最小化/最大化/復元
  test_process_manager.py  # アプリケーションの起動とウィンドウのポーリング
  test_server.py           # MCPツールの登録と統合

テストの追加方法

1. 新しいテストを対応する test_<module>.py ファイルに配置します。
2. conftest.py の共有フィクスチャ（sample_window_info, mcp_server, fake_png_bytes）を使用します。
3. @patch("winsight_mcp.<module>.win32gui") でWin32 APIをモック化します。テストでは実際のWin32関数を呼び出さないでください。
4. サーバー統合テストでは、_call ヘルパーを使用してツールを呼び出し、_text を使用して文字列結果を抽出します。

📄 ライセンス

MIT