Total PC Control

An MCP (Model Context Protocol) server that provides control over your screen, mouse, and keyboard using nut.js.

⚠️ Warning: Use with Caution

This software enables programmatic control of your mouse, keyboard, and other system operations. By using this software, you acknowledge and accept that:

• Giving AI models direct control over your computer through this tool can lead to unintended consequences
• The software can control your mouse, keyboard, and other system functions
• You are using this software entirely at your own risk
• The creators and contributors of this project accept NO responsibility for any damage, data loss, or other consequences that may arise from using this software

Features

• 📷 Screen Capture: Capture screenshots of your entire screen or specific regions
• 🖱️ Mouse Control: Move the mouse cursor, click, double-click, and scroll
• ⌨️ Keyboard Input: Type text and press keyboard shortcuts
• 🪟 Window Management: Find, focus, and manipulate application windows
• 📋 Clipboard Access: Copy and paste text

Prerequisites

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

Installation

1. Clone the repository:

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

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

npm install -g cmake-js

3. Install the libnut core library (required for 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

Using with Claude for Desktop

1. Edit your Claude for Desktop configuration file:

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

2. Add the following to your configuration:

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

Replace /ABSOLUTE/PATH/TO/ with the actual path to where you cloned the repository.

3. Restart Claude for Desktop

4. Look for the hammer icon in the Claude interface to indicate available tools.

Available Tools

Screen Capture

• capture_screen: Capture the entire screen as an image
• capture_region: Capture a specific region of the screen

Mouse Control

• move_mouse: Move the mouse cursor to a specific 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: Type text at the current cursor position
• press_key: Press a specific keyboard key or key combination
• hold_key: Hold down a key
• release_key: Release a held 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 Operations

• copy_to_clipboard: Copy text to the clipboard
• paste_from_clipboard: Get text from the clipboard

Development

To run the server in development mode:

npm run dev

To run tests:

npm test

License

This project is licensed under the MIT License - see the LICENSE file for details.