MCPコントロール
モデル コンテキスト プロトコル用の Windows コントロール サーバー。マウス、キーボード、ウィンドウ管理、画面キャプチャ機能などのシステム操作をプログラムで制御できます。
注意: このプロジェクトは現在 Windows のみをサポートしています。
⚠️ 重要な免責事項
このソフトウェアは実験的であり、潜在的に危険です
このソフトウェアを使用することにより、以下の事項を承認し、同意するものとします。
- このツールを通じてAIモデルにコンピューターを直接制御させることは本質的に危険である
- このソフトウェアはマウス、キーボード、その他のシステム機能を制御する可能性があり、予期しない結果を引き起こす可能性があります。
- このソフトウェアは完全に自己責任でご使用ください。
- このプロジェクトの作成者および貢献者は、このソフトウェアの使用によって生じる可能性のある損害、データ損失、またはその他の結果について一切責任を負いません。
- このツールは、適切な安全対策が講じられた管理された環境でのみ使用してください。
自己責任でご利用ください
特徴
- ウィンドウ管理
- すべてのウィンドウを一覧表示する
- アクティブウィンドウの情報を取得する
- ウィンドウタイトルを取得する
- ウィンドウのサイズと位置を取得する
- フォーカスウィンドウ
- ウィンドウのサイズを変更する
- ウィンドウの位置を変更する
- マウスコントロール
- マウスの動き
- クリック操作
- スクロール機能
- ドラッグ操作
- カーソル位置の追跡
- キーボードコントロール
- テキスト入力
- キーの組み合わせ
- キーの押下/解放操作
- キーを押したままにする機能
- 画面操作
- スクリーンキャプチャ
- 画面サイズの取得
- アクティブウィンドウ検出
- クリップボード統合
- クリップボードの内容を取得する
- クリップボードの内容を設定する
- クリップボードをクリア
- クリップボードの状態を確認する
使用法
MCP サーバーの構成
Claude MCP で使用するには、MCP 設定に次の構成を追加します。
Copy
ソースから構築
貢献またはソースからのビルドに興味がある場合は、詳細な手順についてはCONTRIBUTING.md を参照してください。
開発要件
このプロジェクトを開発用にビルドするには、次のものが必要です。
- Windows オペレーティング システム (キー送信者の依存関係に必要)
- Node.js 18 以降 (ビルド ツールを含む公式 Windows インストーラーを使用してインストールします)
- npm パッケージマネージャー
- ネイティブ ビルド ツール:
- node-gyp:
npm install -g node-gyp
- cmake-js:
npm install -g cmake-js
- node-gyp:
利用可能なツール
MCPControl は次のツールを提供します。
get_screenshot
: スクリーンショットをキャプチャするclick_at
: 特定の座標をクリックするmove_mouse
: マウスカーソルを移動するclick_mouse
: 現在の位置をクリックdrag_mouse
: ある位置から別の位置へドラッグするscroll_mouse
: マウスホイールをスクロールするtype_text
: キーボードを使ってテキストを入力するpress_key
: キーボードのキーを押すpress_key_combination
: 複数のキーを同時に押すhold_key
: キーを押し続けるか離すかget_screen_size
: 画面サイズを取得するget_cursor_position
: 現在のカーソル位置を取得するget_active_window
: アクティブウィンドウに関する情報を取得するget_clipboard_content
: クリップボードのテキストを取得するset_clipboard_content
: クリップボードのテキストを設定する
その他にも多数あります!
既知の制限事項
- ウィンドウの最小化/復元操作は現在サポートされていません
- 設定によっては、複数の画面機能が期待どおりに動作しない場合があります。
- get_screenshotユーティリティはVS Code拡張機能Clineでは動作しません。GitHubのissue #1865をご覧ください。
- 一部の操作では、対象アプリケーションに応じて昇格された権限が必要になる場合があります。
- Windowsのみサポートされています
- Ctrlキーの組み合わせ(Ctrl+C、Ctrl+Vなど)を使用すると、stdioの処理の問題によりサーバーがクラッシュする可能性があります。この問題は、MCP仕様の新しいストリーミングHTTPトランスポートプロトコルを使用した今後のリリースで修正される予定です。GitHubのissue #120をご覧ください。
貢献
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
参考文献
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
モデル コンテキスト プロトコル用の Windows コントロール サーバー。マウス、キーボード、ウィンドウ管理、画面キャプチャ機能などのシステム操作をプログラムで制御できます。