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上提交拉取請求。

📄 許可證

[項目許可證信息]