Total Pc Control

🚀 Total PC Control

An MCP (Model Context Protocol) server that uses nut.js to provide you with control over the screen, mouse, and keyboard.

🚀 Quick Start

Total PC Control is an MCP server that leverages nut.js to offer control over the screen, mouse, and keyboard.

⚠️ Important Note

This software allows for programmatic control of your mouse, keyboard, and other system operations through this tool. By using this software, you acknowledge and accept the following:

• Directly granting an AI model control over your computer via this tool may lead to unexpected consequences.
• This software can control your mouse, keyboard, and other system functions.
• You assume full responsibility for the risks associated with using this software.
• The creators and contributors of this project and its contributors are not liable for any damages, data loss, or other consequences resulting from the use of this software.

✨ Features

• 📷 Screen Capture: Capture screenshots of the entire screen or specific areas.
• 🖱️ Mouse Control: Move the mouse cursor, perform single - clicks, double - clicks, and scroll.
• ⌨️ Keyboard Input: Enter text at the current position and press keyboard shortcuts.
• 🪟 Window Management: Find windows by title or application name, bring windows to the foreground, and manipulate application windows.
• 📋 Clipboard Access: Copy and paste text.

📦 Installation

Prerequisites

• Node.js version 16 or higher.
• npm or yarn.
• cmake-js (for building native dependencies).

Steps

1. Clone the repository:

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

2. Install cmake-js globally (for building native dependencies):

npm install -g cmake-js

3. Install the libnut core library (required by nut.js):

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

4. Install dependencies and build the project:

npm install
npm run build

💻 Usage Examples

Using with Claude Desktop

1. Edit your Claude desktop configuration file:

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

2. Add the following content to the configuration file:

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

Replace /ABSOLUTE/PATH/TO/ with the actual location where you cloned the repository. 3. Restart Claude Desktop. 4. Look for the hammer icon in the Claude interface to indicate available tools.

Available Tools

Screen Capture

• capture_screen: Capture an image of the entire screen.
• capture_region: Capture a specific area of the screen.

Mouse Control

• move_mouse: Move the mouse cursor to a specified position.
• click_mouse: Click the mouse at the current position or specified coordinates.
• double_click: Double - click at the current position or specified coordinates.
• right_click: Right - click at the current position or specified coordinates.
• scroll_mouse: Scroll the mouse wheel up or down.

Keyboard Input

• type_text: Enter text at the current position.
• press_key: Press a specific keyboard key or key combination.
• hold_key: Press and hold a key.
• release_key: Release a pressed key.

Window Management

• find_window: Find a window by title or application name.
• focus_window: Bring a window to the foreground.
• get_active_window: Get information about the currently active window.

Clipboard Access

• copy_clipboard: Copy clipboard content.
• paste_clipboard: Paste clipboard content.

📚 Documentation

To contribute to or modify this project, clone the repository and submit a pull request on GitHub.

📄 License

[Project license information]