MCPControl

MCPコントロール

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

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

🔥 なぜ MCPControl なのか?

MCPControl は、AI モデルとデスクトップ間のギャップを埋め、次のものを安全にプログラムで制御できるようにします。

• 🖱️マウスの動きとクリック
• ⌨️キーボード入力とショートカット
• 🪟ウィンドウ管理
• 📸スクリーンキャプチャと分析
• 📋クリップボード操作

🔌 クイックスタート

1. Node.js をインストールします(まだインストールされていない場合)
   # Visit https://nodejs.org and download the latest LTS version
2. Claude クライアントでMCP 設定を構成します。
   { "mcpServers": { "MCPControl": { "command": "npx", "args": [ "--no-cache", "-y", "mcp-control" ] } } }
3. クライアントを再起動すると、MCP メニューに MCPControl が表示されます。

🚀 人気のユースケース

支援型自動化

• アプリケーションテスト: 反復的な UI テストを Claude に委任し、AI がアプリケーションをナビゲートして問題を報告できるようにします。
• ワークフロー自動化: クロードがあなたに代わってアプリケーションを操作し、反復的なタスクを処理するので、あなたはクリエイティブな仕事に集中できます。
• フォーム入力：クロードがあなたの監督下でデータ入力タスクを処理します

AI実験

• AIゲーム：クロードが視覚的なフィードバックを通じて簡単なゲームの遊び方を学ぶ様子をご覧ください
• 視覚的推論：クロードさんの視覚インターフェースを操作し、視覚的なパズルを解く能力をテストします
• 人間とAIのコラボレーション：クロードがあなたの画面を見て複雑なタスクを支援する新しいインタラクションパラダイムを探ります

開発とテスト

• アプリケーション間の統合: 通常は通信しないアプリケーションをブリッジします
• UIテストフレームワーク：視覚的な検証による堅牢なテストシナリオの作成
• デモ作成：製品デモの作成を自動化

⚠️ 重要な免責事項

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

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

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

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

🌟 特徴

🛠️ 開発セットアップ

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

開発要件

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

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

キーセンダーの依存関係は、これらのビルド ツールを必要とする Windows 固有のネイティブ モジュールに依存します。

📋 プロジェクト構造

• /src
  • /handlers - リクエストハンドラーとツール管理
  • /tools - コア機能の実装
  • /types - TypeScript 型定義
  • index.ts - メインアプリケーションのエントリポイント

🔖 リポジトリブランチ

• main - 最新の機能と変更を含むメイン開発ブランチ
• release - 最新の安定タグをミラーリングした安定リリースブランチ (現在 v0.1.22)

バージョンのインストール

npm を使用して MCPControl の特定のバージョンをインストールできます。

📚 依存関係

• @modelcontextprotocol/sdk - プロトコル実装用の MCP SDK
• キーセンダー- Windows 専用の UI 自動化ライブラリ
• clipboardy - クリップボードの処理
• シャープ- 画像処理
• uuid - UUID生成

🚧 既知の制限事項

• ウィンドウの最小化/復元操作は現在サポートされていません
• 設定によっては、複数の画面機能が期待どおりに動作しない場合があります。
• get_screenshotユーティリティはVS Code拡張機能Clineでは動作しません。GitHubのissue #1865をご覧ください。
• 一部の操作では、対象アプリケーションに応じて昇格された権限が必要になる場合があります。
• Windowsのみサポートされています
• クリック精度は現在、1280x720解像度、シングルスクリーンで最適に動作します。オフセット/スケーリングのバグを修正しており、テスターまたはテストツールの作成にご協力いただける方を募集しています。

👥 貢献する

CONTRIBUTING.mdを参照

⚖️ ライセンス

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

📖 参考文献

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