Metadata-Version: 2.4
Name: mcp-window-vision
Version: 0.1.0
Summary: Zero-dependency MCP server giving AI assistants screen vision and Unity Console-log access on macOS.
Project-URL: Homepage, https://github.com/opieeipo/MCPWindowVision
Project-URL: Issues, https://github.com/opieeipo/MCPWindowVision/issues
Author: Matthew Frazier
License-Expression: MIT
License-File: LICENSE
Keywords: macos,mcp,model-context-protocol,screenshot,unity,vision
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# MCP Window Vision

A tiny, **zero-dependency** [MCP](https://modelcontextprotocol.io) 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

```bash
pip install mcp-window-vision
```

This installs the `mcp-window-vision` console command.

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

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

## Use with Claude Code

User scope (available in every project):

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

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

```json
{
  "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

```bash
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
