total-pc-control

🚀 总体PC控制

这是一个MCP（模型上下文协议）服务器，借助nut.js)，能让你对屏幕、鼠标和键盘进行控制。

🚀 快速开始

此软件允许通过该工具进行编程控制您的鼠标、键盘和其他系统操作。不过在使用前，请务必仔细阅读以下警告内容。

⚠️ 重要提示

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

✨ 主要特性

• 📷 屏幕捕获：捕获整个屏幕或特定区域的截图
• 🖱️ 鼠标控制：移动鼠标光标，单击，双击和滚动
• ⌨️ 键盘输入：在当前位置输入文本并按键盘快捷键
• 🪟 窗口管理：通过标题或应用程序名称查找窗口，将窗口带到前台并操作应用程序窗口
• 📋 剪贴板访问：复制和粘贴文本

📦 安装指南

先决条件

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

安装步骤

1. 克隆仓库：

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

2. 全局安装cmake-js（用于构建本机依赖项）：

npm install -g cmake-js

3. 安装libnut核心库（nut.js所需的库）：

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

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

npm install
npm run build

💻 使用示例

与Claude Desktop一起使用

1. 编辑您的Claude桌面配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 将以下内容添加到配置文件中：

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

将/ABSOLUTE/PATH/TO/替换为您实际克隆仓库的位置。

3. 重启Claude桌面。

4. 查找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_clipboard：复制剪贴板内容
• paste_clipboard：粘贴剪贴板内容

📚 详细文档

要贡献或修改此项目，请克隆仓库并在GitHub上提交拉取请求。

📄 许可证

[项目许可证信息]