NutJS Windows Control - MCP 服务器

本项目是一个基于 nut.js 和 Model Context Protocol (MCP) 构建的 Windows 控制服务器。它允许你通过程序化的方式控制 Windows 系统，包括鼠标、键盘、窗口管理和屏幕截图等操作，从而可以作为 LLM 客户端的后端，提供系统交互能力。

主要功能

窗口管理: 列出窗口、获取活动窗口信息、聚焦、调整大小和位置。
鼠标控制: 移动鼠标、点击、滚动、拖拽和获取光标位置。
键盘控制: 文本输入、按键、组合键和按住按键操作。
屏幕操作: 屏幕截图和获取屏幕尺寸。
剪贴板集成: 获取、设置和清除剪贴板内容。

安装步骤

克隆仓库:

git clone https://github.com/Cheffromspace/nutjs-windows-control.git
cd nutjs-windows-control

构建 libnut-core (如果需要): 如果你没有付费的 NutJS 许可证，需要从源码构建 'libnut-core'。

npm install -g cmake-js  # 全局安装 cmake-js (构建依赖)
cd ..
git clone https://github.com/nut-tree/libnut.git libnut-core
cd libnut-core
npm install
cmake-js rebuild
cd ../nutjs-windows-control

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要将此项目配置为 MCP 服务器，你需要在 MCP 客户端（例如 Claude）中添加以下配置。这里的配置信息描述了如何启动 'windows-control' 服务。

{
  "mcpServers": {
    "windows-control": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "[安装位置]\\nutjs-windows-control\\build\\index.js"
      ]
    }
  }
}

配置说明:

'"mcpServers"': 定义 MCP 服务器配置的对象。
'"windows-control"': 你为此服务指定的名称，在客户端中用于引用。
'"command"': 启动服务器的命令，这里是 Node.js 的可执行文件路径。请根据你的 Node.js 安装路径进行调整。
'"args"': 传递给命令的参数，这里指定了 'nutjs-windows-control' 服务器入口文件 'index.js' 的构建后路径。 请将 '[安装位置]' 替换为你克隆 'nutjs-windows-control' 仓库的实际路径。 例如，如果仓库克隆在 'C:\Users\YourUser\Documents\nutjs-windows-control'，则应将 '[安装位置]' 替换为 'C:\Users\YourUser\Documents'。

配置完成后，重启 MCP 客户端以加载 'windows-control' 服务。

基本使用方法

启动服务器:
```
npm start
```
服务器将在 stdio 上运行，等待 MCP 客户端连接。
在 MCP 客户端中使用: 在你的 MCP 客户端中配置并启用 'windows-control' 服务后，客户端就可以通过 MCP 协议调用服务器提供的工具和资源，例如控制鼠标、键盘、获取屏幕截图等。具体的工具和资源列表可以参考 'src/handlers/tools.ts' 和 'src/handlers/resources.ts' 文件中的定义。你可以使用客户端提供的界面或 API 来调用这些功能。

例如，在 Claude 中配置并启动此服务器后，你就可以指示 Claude 使用 'windows-control' 服务提供的工具来操作你的 Windows 系统。

undefined

关键词

NutJS Windows Control - MCP 服务器

主要功能

安装步骤

服务器配置

基本使用方法

信息