内容
# supernote-mirror-mcp
MCP 服务器，通过 Supernote 平板电脑的内置屏幕投射功能捕获屏幕。
捕获的图像可以进行差异比较、修剪到墨水区域、裁剪和缩放，以减少视觉令牌的使用：原始帧的成本约为 2500 个令牌，而几行字修剪后的半尺寸捕获成本约为 70 个令牌。在 A6 X2 “Nomad”型号（1404x1872）上测量，该型号是唯一经过测试的型号；像 Manta（1920x2560）这样的大屏幕成本成比例增加。
## 前置条件
- Supernote 平板电脑在同一 Wi-Fi 网络上，从快速访问面板启用屏幕镜像（从屏幕顶部向下滑动并点击镜像图标，位于旋转图标旁边）。启用镜像时，会显示一个包含设备 URL 的对话框；第一次触摸后对话框会消失。
- [uv](https://docs.astral.sh/uv/)，用于 `uvx`。
## 安装
使用 Claude Code：
```sh
claude mcp add supernote -- uvx supernote-mirror-mcp
```
对于任何其他 MCP 客户端，请将 `uvx supernote-mirror-mcp` 注册为 stdio 服务器。该命令不带任何参数。使用标准 JSON 配置：
```json
{
"mcpServers": {
"supernote": {
"command": "uvx",
"args": ["supernote-mirror-mcp"]
}
}
}
```
## 工具
- `setup` - 更新或报告配置并检查设备连接。
- `capture_screen` - 返回适合 LLM 直接解释的图像。支持可选的区域裁剪（`x`/`y`/`w`/`h`）和自动修剪周围空白的 `auto_trim`。
- `capture_changes` - 返回自上次捕获以来发生变化的区域。
## 配置
首次使用时，使用镜像对话框中的地址（`host`，加上 `port` 如果不是默认的 8080）调用 `setup` 工具；它应用选项并报告设备是否响应。可选的 `save` 参数将配置写入平台配置目录中的 `config.json`，以便未来会话开始时已连接。
## 许可证
MIT
