Metadata-Version: 2.4
Name: supernote-mirror-mcp
Version: 0.1.1
Summary: MCP server that captures the screen of a Supernote tablet via its built-in screencast
License-Expression: MIT
License-File: LICENSE
Requires-Dist: mcpatom>=0.1.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# supernote-mirror-mcp

MCP server that captures the screen of a Supernote tablet via its built-in
screencast.

## Prerequisites

- A Supernote tablet on the same Wi-Fi network, with screen mirroring enabled
  from the quick-access panel (swipe down from the top of the screen and tap
  the mirroring icon, beside the rotate icon). Enabling mirroring shows a
  dialog with the device's URL; it disappears at the first touch.
- [uv](https://docs.astral.sh/uv/), for `uvx`.

## Setup

With Claude Code:

```sh
claude mcp add supernote -- uvx supernote-mirror-mcp
```

For any other MCP client, register `uvx supernote-mirror-mcp` as a stdio
server. The command takes no arguments. With the standard JSON config:

```json
{
  "mcpServers": {
    "supernote": {
      "command": "uvx",
      "args": ["supernote-mirror-mcp"]
    }
  }
}
```

## Tools

- `setup` - set the tablet's address and check the connection.
- `capture_screen` - capture the current screen as a PNG image.

## Configuration

On first use, call the `setup` tool with the address from the mirroring dialog
(`host`, plus `port` if not the default 8080); it applies the options and
reports whether the device is responding. The optional `save` parameter
writes the configuration to `config.json` in the platform config directory so
future sessions start connected.

## Licence

MIT
