Total Pc Control

全面PC控制

一个MCP（模型上下文协议）服务器，通过以下方式提供对屏幕、鼠标和键盘的控制 nut.js.

⚠️ 警告：小心使用

该软件支持对鼠标、键盘和其他系统操作进行编程控制。使用本软件即表示您承认并接受：

• 通过此工具让AI模型直接控制您的计算机可能会导致意想不到的后果
• 该软件可以控制您的鼠标、键盘和其他系统功能
• 您使用此软件的风险完全由您自行承担
• 本项目的创建者和贡献者对使用本软件可能造成的任何损坏、数据丢失或其他后果不承担任何责任

特性

• 📷 屏幕捕获：捕获整个屏幕或特定区域的屏幕截图
• 🖱️ 鼠标控制：移动鼠标光标，单击、双击和滚动
• ⌨️ 键盘输入：键入文本并按键盘快捷键
• 🪟 窗口管理：查找、聚焦和操纵应用程序窗口
• 📋 剪贴板访问：复制和粘贴文本

先决条件

• Node.js 16或更高版本
• npm或纱线
• cmake js（用于构建本机依赖）

安装

1. 克隆存储库：

git clone https://github.com/jasondsmith72/total-pc-control.git
cd total-pc-control

1. 全局安装cmake js（构建本机依赖项所需）：

npm install -g cmake-js

1. 安装libnut核心库（nut.js需要）：

git clone https://github.com/nut-tree/libnut.git libnut-core
cd libnut-core
npm install
cmake-js rebuild
cd ..

1. 安装依赖项并构建项目：

npm install
npm run build

使用Claude for Desktop

1. 编辑您的Claude for Desktop配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

1. 将以下内容添加到您的配置中：

{
  "mcpServers": {
    "total-pc-control": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/total-pc-control/build/index.js"
      ]
    }
  }
}

替换 /ABSOLUTE/PATH/TO/ 带有克隆存储库的实际路径。

1. 重新启动桌面版的Claude

1. 在Claude界面中查找锤子图标，以指示可用的工具。

可用工具

屏幕捕获

• capture_screen：将整个屏幕捕获为图像
• capture_region：捕获屏幕的特定区域

鼠标控制

• move_mouse：将鼠标光标移动到特定位置
• click_mouse：在当前位置或指定坐标处单击鼠标
• double_click：双击当前位置或指定坐标
• right_click：在当前位置或指定坐标上单击鼠标右键
• scroll_mouse：向上或向下滚动鼠标滚轮

键盘输入

• type_text：在当前光标位置键入文本
• press_key：按特定键盘键或组合键
• hold_key：按住一个键
• release_key：松开按住的键

窗口管理

• find_window：按标题或应用程序名称查找窗口
• focus_window：把窗户带到前台
• get_active_window：获取当前活动窗口的信息

剪贴板操作

• copy_to_clipboard：将文本复制到剪贴板
• paste_from_clipboard：从剪贴板获取文本

发展

要在开发模式下运行服务器，请执行以下操作：

npm run dev

要运行测试，请执行以下操作：

npm test

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。