分屏 MCP（Windows）

提供 16 种分屏工具：

• 窗口左半屏 / 窗口右半屏 / 窗口上半屏 / 窗口下半屏
• 窗口左上四分屏 / 窗口右上四分屏 / 窗口左下四分屏 / 窗口右下四分屏
• 窗口左三分之一 / 窗口中三分之一 / 窗口右三分之一
• 窗口左三分之二 / 窗口右三分之二
• 窗口最大化 / 窗口全屏 / 窗口最小化

功能要点：

• 识别当前应分屏窗口（最上层应用，排除 aido 等宿主程序）
• 精确计算目标区域（按工作区像素对齐，多显示器按窗口中心选屏）
• 通过 PowerShell + Win32 API 操作窗口

安装

pnpm i
pnpm -w run build

运行

node dist/index.js

注意

• 本工具仅支持 Windows 系统
• 使用 PowerShell 和 Win32 API 进行窗口管理
• 默认排除的宿主程序：aido|aidogpt|rapido|kiro（Cursor 可以被分屏）
• 可以通过环境变量 MCP_SPLITSCREEN_HOST 自定义宿主程序匹配模式

常见问题

1. 提示 "无法找到可用窗口进行分屏" 怎么办？

可能原因：

• 当前没有其他可见窗口打开
• 所有窗口都被最小化了
• 窗口太小（宽度或高度 < 50 像素）
• 窗口是系统窗口（如任务栏、桌面）

解决方法：

1. 确保有至少一个普通应用窗口打开（如浏览器、记事本、文件夹）
2. 将窗口从最小化状态恢复
3. 将要分屏的窗口置于前台（点击激活）

2. 日志文件在哪里？

日志文件位置：~/.mcp/screens-mcp/screens.log （Windows 路径：C:\Users\用户名\.mcp\screens-mcp\screens.log）

3. 如何让某个程序也被排除不分屏？

设置环境变量（在 MCP 配置中）：

{
  "env": {
    "MCP_SPLITSCREEN_HOST": "(?i)(aido|cursor|myapp)"
  }
}