Total PC Control

PC 全体の制御

nut.js を使用して、画面、マウス、キーボードを制御する MCP（Model Context Protocol）サーバーです。

⚠️ 警告：注意してご使用ください

このソフトウェアでは、マウス、キーボード、その他のシステム操作をプログラムから制御できます。このソフトウェアを使用することで、以下を認識し、受け入れたものとします。

• このツールを通じて 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 for Desktop での使用

1. Claude for Desktop の設定ファイルを編集します。

• 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 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：クリップボードからテキストを取得します

開発

開発モードでサーバーを実行するには、次のコマンドを実行します。

npm run dev

テストを実行するには、次のコマンドを実行します。

npm test

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。