MCPコントロール

モデルコンテキストプロトコル用の Windows コントロールサーバー。マウス、キーボード、ウィンドウ管理、画面キャプチャ機能などのシステム操作をプログラムで制御できます。

注意: このプロジェクトは現在 Windows のみをサポートしています。

⚠️ 重要な免責事項

このソフトウェアは実験的であり、潜在的に危険です

このソフトウェアを使用することにより、以下の事項を承認し、同意するものとします。

このツールを通じてAIモデルにコンピューターを直接制御させることは本質的に危険である
このソフトウェアはマウス、キーボード、その他のシステム機能を制御する可能性があり、予期しない結果を引き起こす可能性があります。
このソフトウェアは完全に自己責任でご使用ください。
このプロジェクトの作成者および貢献者は、このソフトウェアの使用によって生じる可能性のある損害、データ損失、またはその他の結果について一切責任を負いません。
このツールは、適切な安全対策が講じられた管理された環境でのみ使用してください。

自己責任でご利用ください

特徴

ウィンドウ管理
- すべてのウィンドウを一覧表示する
- アクティブウィンドウの情報を取得する
- ウィンドウタイトルを取得する
- ウィンドウのサイズと位置を取得する
- フォーカスウィンドウ
- ウィンドウのサイズを変更する
- ウィンドウの位置を変更する
マウスコントロール
- マウスの動き
- クリック操作
- スクロール機能
- ドラッグ操作
- カーソル位置の追跡
キーボードコントロール
- テキスト入力
- キーの組み合わせ
- キーの押下/解放操作
- キーを押したままにする機能
画面操作
- スクリーンキャプチャ
- 画面サイズの取得
- アクティブウィンドウ検出
クリップボード統合
- クリップボードの内容を取得する
- クリップボードの内容を設定する
- クリップボードをクリア
- クリップボードの状態を確認する

使用法

MCP サーバーの構成

Claude MCP で使用するには、MCP 設定に次の構成を追加します。

{
  "mcpServers": {
    "MCPControl": {
      "command": "npx",
      "args": [
        "--no-cache",
        "-y",
        "mcp-control"
      ]
    }
  }
}

ソースから構築

貢献またはソースからのビルドに興味がある場合は、詳細な手順についてはCONTRIBUTING.md を参照してください。

開発要件

このプロジェクトを開発用にビルドするには、次のものが必要です。

Windows オペレーティングシステム (キー送信者の依存関係に必要)
Node.js 18 以降 (ビルドツールを含む公式 Windows インストーラーを使用してインストールします)
npm パッケージマネージャー
ネイティブビルドツール:
- node-gyp: npm install -g node-gyp
- cmake-js: npm install -g cmake-js

利用可能なツール

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をご覧ください。

貢献

CONTRIBUTING.mdを参照

ライセンス

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

参考文献

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