mcp-window-vision 0.1.0

Zero-dependency MCP server giving AI assistants screen vision and Unity Console-log access on macOS.

MCP Window Vision

A tiny, zero-dependency MCP server that gives an AI assistant eyes on your macOS screen and access to Unity's Console log — so an agent working on a GUI app (like a Unity project) can see the result and read the errors itself, instead of asking you to screenshot and paste.

Pure Python standard library + macOS's built-in screencapture and sips. Runs on the system Python (3.9+). Nothing to compile, no packages to install for it to run.

Tools

Tool	What it does
capture_screen	Screenshot the main display (downscaled), returned as a PNG image
capture_region	Screenshot a rectangle {x, y, w, h} (pixels)
read_unity_console	Tail Unity's Editor.log (Debug.Log / errors / compile messages); optional substring filter

Requirements

• macOS
• Python 3.9+
• Screen Recording permission for whatever process launches the server (your terminal or MCP client): System Settings → Privacy & Security → Screen Recording.

Install

pip install mcp-window-vision

This installs the mcp-window-vision console command.

Verify screen capture works (and that permission is granted):

mcp-window-vision --selftest
# -> "capture OK — NNNNN base64 chars"

Use with Claude Code

User scope (available in every project):

claude mcp add window-vision --scope user -- mcp-window-vision

…or per-project via a .mcp.json at the project root:

{
  "mcpServers": {
    "window-vision": {
      "type": "stdio",
      "command": "mcp-window-vision"
    }
  }
}

Restart the session so the client picks up the server. (Before publishing/installing, you can point command at python3 with args: ["/path/to/src/mcp_window_vision/server.py"].)

Develop

git clone https://github.com/opieeipo/MCPWindowVision
cd MCPWindowVision
pip install -e .
mcp-window-vision --selftest

Roadmap

• v1 (this): screen/region capture + Unity log reading.
• v2: a Unity-side C# bridge for live editor control (run menu items, inspect serialized references, enter/exit Play) — closing the loop fully.

License

MIT