Tpc Mcpv2

🚀 総合コントロールパネル：コンピュータの完全制御

このソフトウェアは nut.js を使用したモデルコンテキストプロトコル（MCP）サーバーで、画面、マウス、キーボードを完全に制御できます。

⚠️ 注意事項：慎重に使用してください

このソフトウェアは、プログラムによってマウス、キーボード、その他のシステム機能を制御できます。このソフトウェアを使用することで、以下の事実を認識し、受け入れることに同意したことになります。

• このツールを通じてAIモデルにコンピュータの直接制御を与えると、予期しない結果が生じる可能性があります。
• ソフトウェアはマウス、キーボード、その他のシステム機能を制御できます。
• このソフトウェアを使用するリスクはすべて自己責任です。
• このプロジェクトの作成者および貢献者は、このソフトウェアの使用によって生じるデータ損失やその他の結果について一切の責任を負いません。

✨ 主な機能

• 📷 画面キャプチャ：画面全体または特定の領域のスクリーンショットを取得します。
• 🖱️ マウス制御：マウスポインターを移動、クリック（シングル/ダブル）、スクロールします。
• ⌨️ キーボード入力：テキストを入力し、キーボードのショートカットキーを押します。
• 🪟 ウィンドウ管理：アプリケーションウィンドウを検索、フォーカス、操作します。
• 📋 クリップボードアクセス：テキストをコピーして貼り付けます。

📦 インストール

前提条件

• Node.js 16 以上
• npm または yarn
• cmake-js（native 依存関係のビルドに必要）

インストール手順

1. リポジトリをクローンします：

git clone https://github.com/jasondsmith72/Total-PC-Control.git
cd Total-PC-Control

2. 依存関係をインストールします：

npm install

3. 開発環境を起動します：

npm run dev

💻 使用例

基本的な使用法

このサーバーを Claude for Desktop に統合するには、以下の手順に従ってください。

1. C:\Users\<YourUsername>\.claude\config.js ファイルを開きます（ファイルが存在しない場合は作成します）。
2. ファイルの末尾に以下の内容を追加します：

const pcControl = require('@jasondsmith72/total-pc-control');
pcControl.initialize();

3. ファイルを保存し、Claude アプリケーションを再起動します。

高度な使用法

ツールリスト

基本機能（全プラットフォーム対応）

• 画面キャプチャ：

  • captureScreen(): 現在の画面のスクリーンショットを取得します。
  • captureRegion(x, y, width, height): 指定された領域のスクリーンショットを取得します。

• マウス制御：

  • mouseMove(x, y): マウスポインターを指定された座標に移動します。
  • mouseClick(button='left'): マウスをクリックします（左クリックまたは右クリック）。
  • mouseScroll(deltaX, deltaY): マウスホイールをスクロールします。

• キーボード入力：

  • typeText(text): 現在フォーカスされているウィンドウにテキストを入力します。
  • sendKeys(keys): 任意のキーの組み合わせを送信します。

• ウィンドウ管理：

  • getWindowInfo(): すべての開いているウィンドウの情報を取得します。
  • setWindowFocus(title): 指定されたウィンドウをアクティブにします。
  • closeWindow(title): 指定されたウィンドウを閉じます。

高度な機能（Windows システム専用）

• クリップボード操作：

  • copyToClipboard(text): テキストをクリップボードにコピーします。
  • pasteFromClipboard(): クリップボードから内容を貼り付けます。
  • getImageFromClipboard(): クリップボードの画像を取得し、base64 データとして返します。

• Windows UI 自動化ツール（PowerShell 駆動）：

  • 要素情報の照会：
    • getUIElementInfo(windowTitle, options)：
      • 指定されたウィンドウ内のコントロールの詳細情報（名前、AutomationId、クラス名など）を返します。
      • 部分的なウィンドウタイトルの一致をサポートします。
      • 少なくとも 1 つの識別子（名前、AutomationId、またはクラス名）が必要です。
  • 操作の実行：
    • invokeUIAction(windowTitle, action, options)：
      • 指定されたコントロールに対して操作（クリック、値の設定、またはフォーカス）を実行します。
      • 3 種類の操作タイプをサポートします：Click、SetValue、Focus。
      • 操作が SetValue の場合は、値のパラメーターを提供する必要があります。

📚 ドキュメント

開発ガイド

• 開発モードでサーバーを実行するには：

npm run dev

• テストケースを実行するには：

npm test

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細な条項については、LICENSE ファイルを参照してください。