内容
# 全面电脑控制
MCP（模型上下文协议）服务器，通过[nut.js](https://nutjs.dev/)提供对您的屏幕、鼠标和键盘的控制。
## ⚠️ 警告：谨慎使用
该软件启用对鼠标、键盘和其他系统操作的编程控制。使用此软件，即表示您确认并接受：
- 通过此工具给予AI模型直接控制您的计算机可能会导致意想不到的后果
- 软件可以控制您的鼠标、键盘和其他系统功能
- 您完全自行承担使用此软件的风险
- 该项目的创建者和贡献者不对因使用此软件而造成的任何损害、数据丢失或其他后果承担任何责任
## 功能
- 📷 **屏幕捕获**：捕获整个屏幕或特定区域的截图
- 🖱️ **鼠标控制**：移动鼠标光标、单击、双击和滚动
- ⌨️ **键盘输入**：输入文本和按下键盘快捷键
- 🪟 **窗口管理**：查找、聚焦和操作应用程序窗口
- 📋 **剪贴板访问**：复制和粘贴文本
## 前置条件
- Node.js 16 或更高版本
- npm 或 yarn
- cmake-js（用于构建原生依赖项）
## 安装
1. 克隆存储库：
```bash
git clone https://github.com/jasondsmith72/total-pc-control.git
cd total-pc-control
```
2. 全局安装 cmake-js（构建原生依赖项所需）：
```bash
npm install -g cmake-js
```
3. 安装 libnut 核心库（nut.js 所需）：
```bash
git clone https://github.com/nut-tree/libnut.git libnut-core
cd libnut-core
npm install
cmake-js rebuild
cd ..
```
4. 安装依赖项并构建项目：
```bash
npm install
npm run build
```
## 与 Claude for Desktop 一起使用
1. 编辑 Claude for Desktop 配置文件：
- **macOS**：`~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**：`%APPDATA%\Claude\claude_desktop_config.json`
2. 在您的配置中添加以下内容：
```json
{
"mcpServers": {
"total-pc-control": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/total-pc-control/build/index.js"
]
}
}
}
```
将 `/ABSOLUTE/PATH/TO/` 替换为克隆存储库的实际路径。
3. 重启 Claude for Desktop
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_to_clipboard`：将文本复制到剪贴板
- `paste_from_clipboard`：从剪贴板获取文本
## 开发
在开发模式下运行服务器：
```bash
npm run dev
```
运行测试：
```bash
npm test
```
## 许可证
该项目根据 MIT 许可证授权 - 有关详细信息，请参见 LICENSE 文件。
MCP 市场