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でプルリクエストを送信してください。

📄 ライセンス

[プロジェクトのライセンス情報]