Windows Remote Control

🚀 MCPControl 制御サーバー

モデルコンテキストプロトコル（Model Context Protocol）用の Windows 制御サーバーです。プログラミングによるシステム操作の制御をサポートしており、マウス、キーボード、ウィンドウ管理、画面キャプチャ機能を含みます。

注意：このプロジェクトは現在、Windows システムのみをサポートしています。

🚀 クイックスタート

クイックデモ（30 秒での素敵な展示）

MCPControl の魅力を見たいですか？ インタラクティブなデモを試してみてください。

# 1 つのコマンドでデモを実行
node demo.cjs

デモ内容は以下の通りです。

1. 利用可能なすべての MCPControl ツールを表示
2. 画面サイズを表示
3. マウスの位置を追跡
4. アクティブなウィンドウの情報を取得
5. 画面をキャプチャしてデスクトップに保存するかどうかを選択

他のコマンドを実行する必要はありません。デモは自動的に MCPControl サーバーを管理します！

⚠️ 重要な免責事項

このソフトウェアは実験的なもので、潜在的な危険性があります

このソフトウェアを使用することは、以下の内容を承認し受け入れることを意味します。

• このツールを通じて AI モデルが直接あなたのコンピューターを制御することには固有のリスクがあります。
• このソフトウェアはマウス、キーボード、その他のシステム機能を制御できるため、予期しない結果を引き起こす可能性があります。
• このソフトウェアを使用するのは完全にあなた自身の責任です。
• このプロジェクトとその貢献者は、このソフトウェアの使用によって引き起こされる損害、データの喪失、またはその他の結果について責任を負いません。
• このツールは制御された環境で使用し、適切なセキュリティ対策を講じる必要があります。

自己責任で使用してください

✨ 主な機能

• ウィンドウ管理

  • すべてのウィンドウを一覧表示
  • アクティブなウィンドウの情報を取得
  • ウィンドウのタイトルを取得
  • ウィンドウのサイズと位置を取得
  • ウィンドウにフォーカスを設定
  • ウィンドウを拡大/縮小
  • ウィンドウを移動

• マウス制御

  • マウスを移動
  • クリック操作
  • スクロール機能
  • ドラッグ操作
  • マウスの位置を追跡

• キーボード制御

  • テキストを入力
  • キーをシミュレート
  • 特殊キー（Tab、Enter など）を処理

• 画面キャプチャ

  • ウィンドウの内容をキャプチャ
  • 指定された領域をキャプチャ
  • 画面の解像度を取得

• クリップボード操作

  • クリップボードの内容を取得
  • クリップボードの内容を設定
  • コピー＆ペースト機能を管理

📦 インストール

1. 依存関係のインストール：

   npm install mcp-control
   

2. 設定ファイルの作成（例：config.json）：

   {
     "port": 3000,
     "debug": true,
     "clipboardPath": "%APPDATA%/Clipboard"
   }
   

3. サーバーの起動：

   node index.js
   

💻 使用例

基本的な使用法

const MCP = require('mcp-control');
const client = new MCP.Client('localhost', 3000);

async function main() {
  await client.connect();
  console.log(await client.getActiveWindow());
  await client.setClipboardContent("Hello, World!");
  await client.disconnect();
}

main().catch(console.error);

既知の制限

• ウィンドウの最小化/復元操作は現在サポートされていません。
• 一部の画面機能は環境設定によって正常に動作しない場合があります。
• get_screenshot ツールは VS Code 拡張機能の Cline と互換性がありません。詳細は GitHub の問題 #1865 を参照してください。
• 一部の操作は対象アプリケーションによっては管理者権限が必要になる場合があります。
• 現在は Windows システムのみをサポートしています。
• Ctrl キーの組み合わせ（Ctrl+C、Ctrl+V など）を使用すると、stdio の処理問題によりサーバーがクラッシュする可能性があります。この問題は、MCP 仕様の新しいストリーミング HTTP 転送プロトコルによって次のリリースで解決されます。詳細は GitHub の問題 #120 を参照してください。

貢献ガイド

詳細は CONTRIBUTING.md を参照してください。

📄 ライセンス

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

参考資料

• モデルコンテキストプロトコルのドキュメント