SXS Control

SXS Control 把截图、鼠标键盘和文件操作，接入支持本地工具调用的 AI 助手。AI 助手理解你的请求，SXS Control 在当前电脑上执行操作。

电脑操作在本机完成。你使用的 AI 模型是否联网、会接收哪些内容，由所连接的客户端决定。

能帮你做什么

共提供 39 个工具入口，包含部分兼容别名。具体参数见完整工具清单。

Related MCP server: rvn

开始使用

需要 Windows 10/11、Python 3.10 或更高版本，以及 Git。桌面操作需要电脑处于可正常交互的状态。目前采用源码安装。

1. 安装并检查环境

在 PowerShell 中依次执行：

git clone https://github.com/wenmingsun60-bit/sxs-control.git
cd sxs-control
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install .
.\.venv\Scripts\python.exe -m sxs_control init
.\.venv\Scripts\python.exe -m sxs_control doctor

doctor 显示 ok: true、tool_count: 39，且依赖都有版本号，表示环境检查通过。已有配置的用户跳过 init，保留原有设置。

2. 试一次电脑状态查询

$sxsPython = ".\.venv\Scripts\python.exe"
'{}' | & $sxsPython -X utf8 -m sxs_control call windows_device_status --args-stdin

结果中的 isError: false 表示调用成功。这一步只查询状态，方便你先确认工具能够运行。

3. 接入你的 AI 助手

客户端需要支持在本机启动工具进程，通常通过 MCP stdio 连接。把下方配置加入客户端，并将 command 替换为刚才虚拟环境中 Python 的实际路径：

{
  "mcpServers": {
    "sxs-control": {
      "command": "C:\\path\\to\\sxs-control\\.venv\\Scripts\\python.exe",
      "args": ["-X", "utf8", "-m", "sxs_control", "--stdio"]
    }
  }
}

只接受云端 MCP 链接的客户端，无法直接连接这份本地版本。命令行和本机 HTTP 的用法见配置与连接方式。

安装报错、依赖缺失或连接失败，请看首次运行与排错。

工作目录与权限

首次初始化会创建 ~/SXSWorkspace，文件工具默认只访问这个目录。可以在配置中调整允许目录，具体方法见配置说明。

工具以当前 Windows 用户的权限运行。 文件目录限制只约束文件工具；PowerShell、鼠标键盘、应用启动和注册表操作可以影响目录之外的内容。请连接受信任的客户端，并在客户端确认有副作用的操作。

项目进展与参与

当前源码为 0.1.1 Alpha，仍在完善。自动化测试包含 23 项用例；真实电脑、桌面操作和不同客户端的验证范围见验证记录。

致谢与许可

由孙文明（Sun Wenming）维护。早期工作流使用过 Windows-MCP，并参考过 Desktop Commander 的工具组织，感谢上游作者。

本仓库新增代码采用 MIT 许可，外部依赖保留各自许可证。代码来源和许可范围见来源说明与第三方声明。