Little Mouse Pointer

English README

このリポジトリは Little Mouse Pointer を提供します。これは AI エージェント向けの Windows デスクトップ UI コンテキストピッカーです。ユーザーはマウスでウィンドウ、UI 要素、または画面領域を選択し、UI Automation、スクリーンショット、およびローカル OCR を通じてコンテキストを取得し、確認後に MCP 経由で OpenAI Codex、DeepSeek Harness、またはその他の互換クライアントに提供できます。

プラグインディレクトリは plugins/little-mouse-pointer です。完全な機能、プロトコル、およびランタイムの説明は、プラグインディレクトリ内の README を参照してください。

ドキュメントナビゲーション

• 初心者チュートリアル：初回インストール、初回選択、および一般的な問題の完全な手順。

• 初心者向けインストールチェックリスト：Codex、DeepSeek Harness、手動実行のシナリオごとに項目を確認します。

• プラグイン完全 README：機能、使用手順、プライバシー制限、および障害の境界。

• ランタイム説明：self-contained ランタイムパッケージ、run.ps1、および MCP stdio の動作。

• DeepSeek Harness 設定：bundle が利用できない場合の手動 Cordis 設定。

• プロトコル説明：ツール出力フィールドと確認フロー。

Related MCP server: atomic-computer-mcp

GitHub から Codex へのインストール

PowerShell で以下のコマンドを実行し、OWNER/REPOSITORY を実際の GitHub リポジトリに置き換えます：

codex plugin marketplace add OWNER/REPOSITORY --ref main
codex plugin add little-mouse-pointer@auto-mouse

プラグインディレクトリのみをダウンロードする場合は、GitHub release zip を使用するか、ローカルに plugins/little-mouse-pointer の階層をインストールできます。リポジトリのルートディレクトリを直接プラグインのルートディレクトリと誤解しないでください。

DeepSeek Harness への接続

中国語インストールチェックリスト または English installation checklist をコピーし、DeepSeek Harness 設定 を参照して、パスを実際のディレクトリに変更します。MCP stdio は直接起動する必要があります：

plugins/little-mouse-pointer/app/MousePointer.Windows.exe

run.ps1 を MCP stdio bridge として使用しないでください。run.ps1 は GUI と self-test を手動で起動するためだけに使用します。

GitHub から Harness bundle を直接インストール

リポジトリのルートディレクトリには、Harness の dsh.bundle 仕様に準拠したインストールパッケージも用意されています。リリースタグを固定することをお勧めします：

dsh plugin --profile demo add github:Fish121380/auto-mouse#v0.1.1
dsh --profile demo --dump-config

この bundle は、同梱の Windows x64 exe を自動的に特定し、@deepseek-ai/dsh-mcp-client を登録します。これは Windows x64 でのみ動作します。ポートはプロファイルの cordis.patch.yml で上書きできます：

- replace:
    - id: little-mouse-pointer
      config:
        port: 49154

インストール前の確認

• Windows 10/11 x64。

• .NET のインストールは不要です。配布パッケージはすでに self-contained です。

• plugins/little-mouse-pointer/app のすべてのファイルを保持してください。

• デフォルトポートは 49153 で、エンドポイントと MOUSE_POINTER_HTTP_PORT は一致している必要があります。

• Codex/Harness を実行する前に、古い Little Mouse Pointer インスタンスを終了してください。

• MCP ツールは ui_context_pick、ui_context_current、ui_context_clear です。