桌面自动化协议服务

滚动MCP

模型上下文协议（MCP）服务器，使AI代理能够在 滚动Wayland合成器。此服务器与 星语机器人 提供强大的窗口管理、屏幕截图、鼠标和键盘控制功能。

特性

• 窗口管理：按各种属性（名称、app_id、类、pid、id）列出、聚焦和操纵窗口
• 截图：通过自动HiDPI缩放处理捕获整个桌面或特定窗口
• 鼠标控制：通过坐标平移单击、拖动、滚动和移动鼠标
• 键盘输入：键入文本并发送键盘快捷键
• 智能校准：自动坐标系校准，可在不同DPI范围内精确定位鼠标
• Flatpak/XWayland支持：通过WM_CLASS匹配对Flatpak和XWayland应用程序进行特殊处理

需求

• 滚动：Wayland合成器(scrollmsg CLI工具必须可用）
• Ydotool：Linux命令行自动化工具（守护进程必须正在运行）
• 严峻：Wayland的屏幕截图实用程序
• jq：用于解析scrollmsg输出的JSON处理器
• wl查找光标：读取光标位置的工具（用于校准）
• 包子：JavaScript运行时和包管理器

NixOS用户

如果您使用的是NixOS，请参阅 astrbot.service示例 用于systemd服务配置。

安装

# Install dependencies
bun install

用法

运行服务器

bun run index.ts

与Astribot集成

配置Astribot以使用此MCP服务器。服务器使用模型上下文协议通过stdio进行通信。

环境变量

• ASTRBOT_ROOT：Astribot的根目录（默认：当前工作目录）
• 附件保存到 $ASTRBOT_ROOT/data/attachments/