Skip to content

Releases: yxpil/PANOPTES

Release list

PANOPTES v0.1.0

Choose a tag to compare

@github-actions github-actions released this 04 Sep 14:33

Screen operation MCP server for AI agents — screenshots plus mouse and keyboard control over Streamable HTTP JSON-RPC.

面向 AI 智能体的屏幕操作 MCP 服务器 —— 通过 Streamable HTTP(JSON-RPC 2.0)提供屏幕截图与鼠标键盘控制。

Highlights / 亮点

  • 9 MCP tools: screenshot, screen_info, mouse_position, mouse_move, mouse_click, mouse_drag, mouse_scroll, key_type, key_press
  • Retina / HiDPI accurate: every screenshot reports the pixel → global-logical-coordinate mapping, so the agent can look at a pixel and click exactly there / 每张截图都附带像素到全局逻辑坐标的换算,看图点哪就点哪
  • Control gate: the 7 input tools refuse to run unless the server is started with --yes-i-can-control-this-machine (or PANOPTES_I_CAN_CONTROL=yes) / 输入工具需显式授权才会运行
  • Screenshot-only mode: read-only tools work without the macOS Accessibility permission / 纯截图模式无需辅助功能权限
  • BIT compatible: speaks MCP protocol versions 2024-11-05 / 2025-03-26 / 2025-06-18; verified against BIT's MCP client
  • Cross-platform: macOS (Apple Silicon), Linux x86_64 (X11), Windows x86_64

Install / 安装

Download the archive for your platform and SHA-256 checksum below, or:

下载对应平台压缩包与 SHA-256 校验文件,或:

cargo install --git https://github.com/yxpil/PANOPTES
# macOS Apple Silicon example / 示例
tar xzf panoptes-v0.1.0-aarch64-apple-darwin.tar.gz
sudo mv panoptes /usr/local/bin/

# screenshots only / 仅截图
panoptes serve
# with input control unlocked / 解锁输入控制
panoptes serve --yes-i-can-control-this-machine

Docs: README · Wiki · Protocol