open-index/open-npm huggingface dataset:
npm package: @mcpcn/mcp-split-screen
Description: Windows 分屏窗口管理 MCP
Author: 享泉
Latest version: 1.0.96

# 分屏 MCP（Windows）

提供 16 种分屏工具：
- 窗口左半屏 / 窗口右半屏 / 窗口上半屏 / 窗口下半屏
- 窗口左上四分屏 / 窗口右上四分屏 / 窗口左下四分屏 / 窗口右下四分屏
- 窗口左三分之一 / 窗口中三分之一 / 窗口右三分之一
- 窗口左三分之二 / 窗口右三分之二
- 窗口最大化 / 窗口全屏 / 窗口最小化

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

## 安装

```bash
pnpm i
pnpm -w run build
```

## 运行

```bash
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 配置中）：
```json
{
  "env": {
    "MCP_SPLITSCREEN_HOST": "(?i)(aido|cursor|myapp)"
  }
}
```
npm package: @mcpcn/mcp-split-screen-mac
Description: 跨平台分屏窗口管理 MCP（macOS/Windows）
Author: 享泉
Latest version: 1.0.13

# 分屏 MCP（macOS/Windows）

提供 16 种分屏工具：
- 窗口左半屏 / 窗口右半屏 / 窗口上半屏 / 窗口下半屏
- 窗口左上四分屏 / 窗口右上四分屏 / 窗口左下四分屏 / 窗口右下四分屏
- 窗口左三分之一 / 窗口中三分之一 / 窗口右三分之一
- 窗口左三分之二 / 窗口右三分之二
- 窗口最大化 / 窗口全屏 / 窗口最小化

功能要点：
- 识别当前应分屏窗口（最上层应用，排除 aido）
- 精确计算目标区域（按工作区像素对齐，多显示器按窗口中心选屏）
- macOS 通过 AppleScript/JXA 与 AppKit 获取工作区并移动窗口
- Windows 通过 node-window-manager 操作窗口

安装
  
```bash
pnpm i
pnpm -w run build
```

运行
```bash
node dist/index.js
```

注意
- Windows 需要可选依赖 `node-window-manager`
- macOS 需要为"辅助功能"授权终端/宿主（以便 System Events 控制窗口）