🪟 Windows-MCP

🪟 Windows-MCP

Windows-MCP は、AI エージェントと Windows オペレーティングシステムをシームレスに連携させる、軽量なオープンソースプロジェクトです。MCP サーバーとして機能し、LLM と Windows オペレーティングシステムの間を橋渡しすることで、エージェントがファイルのナビゲーション、アプリケーションの制御、UI 操作、QA テストなどのタスクを実行できるようにします。

mcp-name: io.github.CursorTouch/Windows-MCP

更新情報

• Windows-MCP は Claude Desktop Extensiosn で 2M+ Users に到達しました。
• Windows-MCP を使って構築されたエージェント、🪟Windows-Use をお試しください。
• Windows-MCP が PyPI で利用可能になりました（そのため、uvx windows-mcp に対応しています）。
• Windows-MCP が MCP Registry に追加されました。

対応オペレーティングシステム

• Windows 10
• Windows 11

現在のパッケージには Python 3.14 以降が必要です。これはWindows 10 以降に対応しています。現在のインストール方法では、それ以前のバージョンの Windows はサポートされていません。

🎥 デモ

https://github.com/user-attachments/assets/d0e7ed1d-6189-4de6-838a-5ef8e1cad54e

https://github.com/user-attachments/assets/d2b372dc-8d00-4d71-9677-4c64f5987485

✨ 主な機能

• Windows とのシームレスな統合
  Windows の UI 要素とネイティブに連携し、アプリを開いたり、ウィンドウを操作したり、ユーザー入力をシミュレートしたりできます。

• あらゆる LLM を使用可能（ビジョン機能は任意） 多くの自動化ツールとは異なり、Windows-MCP は従来のコンピュータービジョン技術や特定のファインチューニング済みモデルに依存しません。あらゆる LLM で動作するため、複雑さとセットアップ時間を抑えられます。

• UI 自動化のための豊富なツールセット
  基本的なキーボード・マウス操作や、ウィンドウ／UI の状態取得に使えるツールが含まれています。

• 軽量でオープンソース
  依存関係は最小限で、セットアップも簡単です。ソースコードは MIT ライセンスで公開されています。

• カスタマイズと拡張が容易
  独自の自動化や AI 統合のニーズに合わせて、ツールを簡単に調整または拡張できます。

• リアルタイムのインタラクション
  アクション間（例：マウスクリックから次のクリックまで）の一般的な遅延は 0.2～0.5 秒 です。アクティブなアプリケーションの数やシステム負荷、LLM の推論速度によって多少変動する場合があります。

• ブラウザー自動化のための DOM モード
  State-Tool の専用モード use_dom=True は、ウェブページのコンテンツのみに焦点を当て、ブラウザーの UI 要素を除外することで、より効率的で扱いやすいウェブ自動化を実現します。Chrome、Edge、Firefox に対応しています（Firefox は UIA 経由で RootWebArea を公開しないため、IAccessible2 にフォールバックします）。

🛠️インストール

注意： この MCP サーバーを初めてインストールする際は、pyproject.toml の依存関係をインストールするため、1～2 分かかることがあります。初回起動時にサーバーがタイムアウトする場合がありますが、そのまま再起動してください。

前提条件

• Python 3.14+
• Astra の UV（パッケージマネージャー）。pip install uv または curl -LsSf https://astral.sh/uv/install.sh | sh でインストールしてください
• App ツールは、ローカライズされたスタートメニューの表示名と内部アプリ名の両方を解決します。Windows の表示言語を英語にする必要はありません。

ログイン時に実行

必要に応じてサーバーを直接実行します。

uvx windows-mcp serve
uvx windows-mcp serve --transport sse --host localhost --port 8000
uvx windows-mcp serve --transport streamable-http --host localhost --port 8000

バックグラウンドタスクとしてインストールし、今すぐ、またログインのたびに起動するようにします。

windows-mcp install

# Or choose the HTTP transport and bind address explicitly
windows-mcp install --transport sse --host 127.0.0.1 --port 8000

これにより、ユーザーごとのスケジュールタスク windows-mcp-server と、ラッパースクリプト ~/.windows-mcp/start-server.cmd が作成されます。削除するには windows-mcp uninstall を使用してください。ログは ~/.windows-mcp/server.log と ~/.windows-mcp/server.error.log に書き込まれます。

npm install -g @anthropic-ai/mcpb

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp",
        "serve"
      ]
    }
  }
}

git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path to the windows-mcp directory>",
        "run",
        "windows-mcp",
        "serve"
      ]
    }
  }
}

{
  "mcpServers": {
    "windows-mcp": {
      "command": "C:\\Users\\<user>\\.local\\bin\\windows-mcp.exe",
      "args": ["serve"]
    }
  }
}

{
  "mcpServers": {
    "windows-mcp": {
      "command": "C:\\Users\\<user>\\.local\\bin\\uvx.exe",
      "args": ["windows-mcp", "serve"]
    }
  }
}

{
  "mcpServers": {
    "windows-mcp": {
      "command": "C:\\Users\\<user>\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\path\\to\\Windows-MCP",
        "run",
        "windows-mcp",
        "serve"
      ]
    }
  }
}

Claude Desktop との連携に関するトラブルシューティングについては、MCP のドキュメントを参照してください。

{
  "command": "uvx",
  "args": [
    "windows-mcp",
    "serve"
  ]
}

{
  "command": "uv",
  "args": [
    "--directory",
    "<path to the windows-mcp directory>",
    "run",
    "windows-mcp",
    "serve"
  ]
}

npm install -g @google/gemini-cli

{
  "theme": "Default",
  ...
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp",
        "serve"
      ]
    }
  }
}

npm install -g @qwen-code/qwen-code@latest

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp",
        "serve"
      ]
    }
  }
}

npm install -g @openai/codex

[mcp_servers.windows-mcp]
command="uvx"
args=[
  "windows-mcp",
  "serve"
]

autohand mcp add windows-mcp uvx windows-mcp serve

npm install -g @anthropic-ai/claude-code

claude mcp add --transport stdio windows-mcp -- uvx windows-mcp serve

git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP

claude mcp add --transport stdio windows-mcp -- uv --directory "<path>" run windows-mcp serve

claude mcp add --transport stdio windows-mcp -- C:\Users\<user>\.local\bin\uvx.exe windows-mcp serve

irm https://astral.sh/uv/install.ps1 | iex

claude mcp add windows-mcp --transport stdio -s user -- powershell.exe -Command "C:\Users\<user>\.local\bin\uvx.exe windows-mcp serve"

🖥️ Windows-MCP の実行

Windows-MCP は Windows マシン上で直接動作し、接続された MCP クライアントにツールを公開します。

# Runs with stdio transport (default)
uvx windows-mcp serve

# Or with SSE/Streamable HTTP for network access
uvx windows-mcp serve --transport sse --host localhost --port 8000
uvx windows-mcp serve --transport streamable-http --host localhost --port 8000

動作をカスタマイズするために、オプションの環境変数を設定できます。詳しくは、以下の環境変数をご覧ください。

リモートアクセスのセキュリティ

ネットワーク経由でアクセスする場合は、認証と TLS を有効にしてください。

windows-mcp serve --transport sse --host 0.0.0.0 \
  --auth-key "your_secret_token" \
  --ip-allowlist "203.0.113.0/24" \
  --ssl-certfile cert.pem --ssl-keyfile key.pem

すべてのオプションについては、🔐 セキュリティとアクセス制御をご覧ください。

トランスポートのオプション

🔐 セキュリティとアクセス制御

認証

windows-mcp serve --transport sse --host 0.0.0.0 --auth-key "your_token"

すべてのリクエストで Authorization: Bearer your_token ヘッダーが必要です。

IP 許可リスト

windows-mcp serve --auth-key "token" --ip-allowlist "203.0.113.0/24,198.51.100.5"

指定された CIDR 範囲からの接続に制限します。デフォルトでは、プライベート IP とループバック IP をブロックします。

CORS オリジン

デフォルトでは、CORS ヘッダーは出力されません。ブラウザーは独自の同一オリジンポリシーによってクロスオリジンリクエストをブロックするため、サーバーが localhost 上にあっても、任意の Web サイトから MCP 制御プレーンにアクセスすることはできません。また、バインドアドレスに基づくホストヘッダー検証（DNS リバインディング対策）も自動的に適用されます。

ブラウザーベースの MCP クライアントからサーバーにアクセスする必要がある場合は、オリジン許可リストを明示してオプトインしてください。

windows-mcp serve --cors-origins "https://my-client.example.com,https://other.example.com"

リストに記載されたオリジンにのみ Access-Control-Allow-Origin ヘッダーが付与され、それ以外のすべてのクロスオリジンリクエストはブラウザーによって拒否されます。対応する環境変数は WINDOWS_MCP_CORS_ORIGINS です。

ツールの選択

デフォルトではすべてのツールが有効です。特定のツールを許可リストに登録するには --tools を、特定のツールをブロックするには --exclude-tools を使用してください。

windows-mcp serve --tools "Screenshot,Click,Snapshot"   # Enable only these tools
windows-mcp serve --exclude-tools "PowerShell,Registry" # Disable specific tools

TLS/HTTPS

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes

windows-mcp serve --ssl-certfile cert.pem --ssl-keyfile key.pem

OAuth 2.0 + PKCE

静的 API キーの代わりに OAuth を使用する MCP クライアント（例：Claude Desktop）向け：

windows-mcp serve --transport streamable-http --host 0.0.0.0 \
  --ssl-certfile ~/.windows-mcp/cert.pem \
  --ssl-keyfile  ~/.windows-mcp/key.pem \
  --oauth-client-id my-client \
  --oauth-client-secret my-secret

Claude Desktop の設定：

{
  "mcpServers": {
    "windows-mcp": {
      "type": "http",
      "url": "https://<host>:8000/mcp/",
      "oauth": {
        "clientId": "my-client",
        "clientSecret": "my-secret"
      }
    }
  }
}

OAuth サーバーは次のエンドポイントを公開します。

• GET /.well-known/oauth-authorization-server — サーバーメタデータ（RFC 8414）
• GET /oauth/authorize — Authorization Code + PKCE（S256 が必須）
• POST /oauth/token — トークン交換（クライアントシークレットが必要）
• POST /oauth/register — 無効。クライアントは事前にプロビジョニングする必要があります。

動的クライアント登録は無効です。リダイレクト URI はループバックの http(s) のみ使用できます。 認証キーと OAuth は併用でき、どちらも有効な Bearer トークンとして受け入れられます。

設定ファイル（~/.windows-mcp/config.toml）

毎回フラグを渡す代わりに、設定を ~/.windows-mcp/config.toml に保存できます。CLI フラグは常に設定ファイルの値より優先されます。

検索順序：

1. --config /path/to/config.toml
2. ~/.windows-mcp/config.toml

stdio — ローカル専用。セキュリティ設定は不要です。

[server]
transport = "stdio"

SSE — 認証と IP 制限を使用したネットワークアクセス：

[server]
transport = "sse"
host      = "0.0.0.0"
port      = 8000
auth_key  = "your-secret-key"

[security]
ip_allowlist = ["192.168.1.0/24"]

Streamable HTTP — 認証、TLS、ツールの除外を使用：

[server]
transport    = "streamable-http"
host         = "0.0.0.0"
port         = 8000
auth_key     = "your-secret-key"
ssl_certfile = "cert.pem"   # resolved relative to ~/.windows-mcp/
ssl_keyfile  = "key.pem"

[security]
ip_allowlist        = ["192.168.1.0/24"]
cors_origins        = ["https://my-client.example.com"]   # optional — browser CORS opt-in
oauth_client_id     = "my-client"      # optional — enables OAuth 2.0 + PKCE
oauth_client_secret = "my-secret"

[tools]
exclude = ["PowerShell", "Registry"]   # disable specific tools

証明書とキーのファイルは同じディレクトリに配置してください。

~/.windows-mcp/
├── config.toml
├── cert.pem
└── key.pem

そのディレクトリに自己署名証明書を直接生成します。

mkdir -p ~/.windows-mcp
openssl req -x509 -newkey rsa:4096 \
  -keyout ~/.windows-mcp/key.pem \
  -out ~/.windows-mcp/cert.pem \
  -days 365 -nodes

デスクトップ制御

デスクトップ制御はデフォルトでrelaxedポリシーにより有効になっています。デスクトップへの直接操作には制限が適用されますが、コンピューターを使用中でもバックグラウンドツールを実行できます。 ~/.windows-mcp/config.toml で設定するか、enabled = false にして完全に無効化できます。

[control]
enabled = true
policy = "relaxed"
idle_timeout_seconds = 10.0

または、MCP サーバーを起動する際に一度だけ上書きできます。

windows-mcp serve --no-control
windows-mcp serve --control --control-idle-timeout 3
windows-mcp serve --control-policy strict

MCP クライアントの起動引数では、これらのオプションを serve の後に指定してください。 優先順位は CLI > 環境変数 > TOML > デフォルトです。--control を指定すると、enabled = false を明示的に上書きできます。タイムアウトには、ゼロより大きい有限の秒数を指定できます（小数も可）。ゼロにしても制御は無効になりません。デフォルトは引き続き 10 秒です。

これらの設定を変更した後は、Windows-MCP サーバープロセスを再起動してください。ホットリロードや AI 設定ツールはありません。ControlStatus には、制御が無効な場合は状態 disabled とともに、有効な enabled、policy、idle_timeout_seconds の値が表示されます。

制御を無効にすると、所有権の制限、物理入力の保護、制御の引き継ぎの監視、制御インジケーターがすべて無効になります。ツールは引き続き利用可能で、直列化されます。また、注入されたキーやボタンのクリーンアップも維持されます。その場合、AI によるデスクトップ操作がユーザー自身の入力と干渉する可能性があり、PowerShell スクリプトも UI を操作できます。スクリーンショットのフラッシュに関する個別の設定は変更されません。制御が有効な場合、物理入力があるとアイドルタイマーがリセットされるため、コンピューターを使い続けている間にタイムアウトを短くしても、制限対象の呼び出しは許可されません。

AI による制御中は、小さなマウス移動は現在のツールを一時停止させずにブロックされます。マウスによる制御の引き継ぎでは、デフォルトで相対的な生の入力による各移動距離を、往復の動きも含めて合計し、デバイス単位で 500 に達すると引き継ぎが行われます。移動がない状態が 0.5 秒続くと新しい区間が始まります。デバイスを切り替えた場合や新しい制御期間が始まった場合も、合計値はリセットされます。しきい値を変更するには、TOML で control.mouse_takeover_units を設定し、サーバーを再起動してください（40～2000）。この単位はデバイス単位であり、画面ピクセルではありません。一部のタッチパッドやリモート入力デバイスなど、識別可能な相対的な生の入力を提供しないデバイスでは、引き継ぎに Ctrl+Alt+Shift+Backspace を使用する必要があります。従来の mouse_takeover_pixels 設定は互換性のため引き続き受け付けられますが、引き継ぎには影響しなくなりました。

デスクトップゲートポリシー

FileSystem、Registry、Snapshot、Screenshot、Scrape、Wait、WaitFor、DisplayInventory、 Process の list、Clipboard の get は、A と B では所有権チェックを受けません。この分類が対象とするのはデスクトップへの干渉であり、権限やデータの安全性ではありません。PowerShell で UI を操作できるほか、ファイルやレジストリの操作が別の副作用を引き起こす場合もあります。

ゲート対象外の呼び出しでは、デスクトップリースを取得または延長せず、インジケーターを有効化せず、ツールロックを待ちません。ただし、既存のリソース制約は引き続き適用されます。UI Automation の操作は専用ワーカーを共有するため、時間のかかる WaitFor によってほかの UIA 処理が遅れることがあります。個別のスクリーンショットフラッシュに変更はありません。--no-control は従来どおり、すべてのツールを直列化し、ポリシーの所有権チェックより優先されます。

relaxed モードでは、エージェントはバックグラウンド作業を優先し、デスクトップへの干渉が予想される場合はユーザーと調整する必要があります。ユーザーのプロセスを妨げたり、フォーカスを奪ったりすると分かっている場合は、既存の許可を再利用して、事前に許可を得てください。これらはツールの使用に関するガイドラインであり、サーバーが承認やプロセスの所有権を追跡するものではありません。Clipboard は引き続き実際の Windows クリップボードを使用し、仮想クリップボードは導入されません。

コントリビューター向け：ツールのカテゴリと、モードごとの少数の例外は src/windows_mcp/tools/control_policy.py にあります。ツールやモードを追加する際は、このテーブルを更新してください。登録カバレッジテストで漏れを検出できます。不明な拡張機能には安全側に倒してゲートを適用します。ポリシーの判断を個々のツール実装に持ち込まないでください。

auth ヘルパー

認証キーを生成し、動作する設定を ~/.windows-mcp/config.toml に保存します。

windows-mcp auth

認証情報と自己署名 TLS 証明書を生成します。

windows-mcp auth --transport streamable-http --host 0.0.0.0 --port 8000 --with-tls

このコマンドは認証キーを設定ファイルに書き込み、cert.pem と key.pem を生成できるほか、選択したトランスポート用の MCP クライアント設定例を出力します。

SSRF 保護

Scrape ツールは、プライベート IP、ループバック、リンクローカル、URL 内の認証情報、HTTP 以外のスキームをブロックします。

⚙️ 環境変数

特に記載がない限り、すべての変数は省略可能です。claude_desktop_config.json（または MCP クライアントに相当する設定）の env キーで設定します。

スクリーンショットとスナップショット

UI Automation の走査からプロセスを除外する

一部のアプリケーションでは、UI Automation の走査中に遅くなったり応答しなくなったりするアクセシビリティツリーが公開されています。Snapshot と WaitFor は、アクティブなウィンドウや、ツリーのキャプチャ対象として選択されたほかのトップレベルハンドルを走査する場合があるため、問題のあるアクセシビリティプロバイダーが一つあるだけでキャプチャが停止することがあります。

次のように設定します。

WINDOWS_MCP_EXCLUDE_PROCESSES=Code.exe,Cursor.exe

プロセス名は、実行可能ファイルのベース名をカンマ区切りで指定します。前後の空白を除去した後、大文字と小文字を区別せずに照合します。空の項目は無視され、重複があっても問題ありません。

ウィンドウは、UI Automation の呼び出しが行われる前に除外されるため、そのウィンドウのアクセシビリティプロバイダーが呼び出されることはありません。除外されたアプリケーションがウィンドウ一覧に表示される場合はありますが、Windows-MCP はそのアクセシビリティツリーを走査せず、キャプチャの失敗として報告することもありません。ウィンドウの所有プロセスを特定できない場合は、通常どおりウィンドウを走査します。

これは除外の仕組みであり、#383 に見られるあらゆる問題を完全に解決するものではなく、緩和策です。指定したプロセスのみをスキップします。リストに含まれていない問題のあるウィンドウによって、キャプチャが停止する可能性はあります。

デスクトップ制御の設定

物理キーまたはボタンの解放イベントが検出されなかった場合、入力モニターは、設定されたアイドル待機時間の後に残存する押下状態を確認します。連続して 5 回、すべて解放された状態をサンプリングし、各サンプルの間隔が 100 ms 以上であれば、古い記録をクリアします。新たな物理入力または押下中のキーやボタンの報告があると、確認状態がリセットされます。これはベストエフォートの動作です。Windows が状態を取得できない場合でも、GetAsyncKeyState の結果が 0 であれば解放済みとして扱われます。繰り返しサンプリングすることで一時的な読み取り値は除外できますが、継続的なクエリ失敗を識別することはできません。

セキュリティ

テレメトリ

デバッグ

WatchDog

claude_desktop_config.json の例：

ローカル（セキュリティなし）：

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": ["windows-mcp", "serve"],
      "env": { "WINDOWS_MCP_SCREENSHOT_SCALE": "0.5" }
    }
  }
}

リモート（認証＋IP 許可リスト＋TLS）：

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": ["windows-mcp", "serve", "--transport", "sse", "--host", "0.0.0.0"],
      "env": {
        "WINDOWS_MCP_AUTH_KEY": "your_token",
        "WINDOWS_MCP_IP_ALLOWLIST": "203.0.113.0/24",
        "WINDOWS_MCP_SSL_CERTFILE": "/path/to/cert.pem",
        "WINDOWS_MCP_SSL_KEYFILE": "/path/to/key.pem"
      }
    }
  }
}

🔨MCP ツール

MCP クライアントは、Windows と連携するために以下のツールにアクセスできます。

• Click：指定した座標を画面上でクリックします。
• Type：要素にテキストを入力します（既存のテキストを消去するかどうかは任意です）。
• Scroll：ウィンドウまたは特定の領域を垂直方向または水平方向にスクロールします。
• Move：マウスポインターを移動するか、座標までドラッグします（drag=True を設定）。決定的なドラッグを行うには、drag=True とともに from_loc=[x, y] を設定すると、1 回のツール呼び出しで明示した開始地点を押し、loc で離します。任意の duration を指定すると、中間の移動を一定の範囲内で追加できます。
• Shortcut：キーボードショートカット（Ctrl+c、Alt+Tab など）を押します。
• Wait：指定した時間だけ一時停止します。
• WaitFor：1 回のツール呼び出し内で UI の状態をポーリングし、テキスト、アクティブウィンドウ、要素、またはフォーカスされた要素が表示されるまで待機します。
• ControlStatus：デスクトップの制御権を持つ主体と、ユーザー操作がない状態で待機する残り時間を読み取ります。ユーザーへの制御引き継ぎによって新たなツール呼び出しがブロックされている間も利用できます。AI が制御している間は、表示される枠線とカーソルの光彩で制御権の所在を示します。物理マウスを大きく動かすか Ctrl+Alt+Shift+Backspace を押すと、操作が 10 秒間ない状態になるまで制御権がユーザーに戻ります。スクリーンショットのキャプチャ中はインジケーターが一時的に非表示になり、物理入力が可能になります。この間に物理入力があると AI の制御は中断されますが、そのイベントが処理されるまでの短時間、ControlStatus が ai を報告する場合があります。段階的なデスクトップ入力は次のチェックポイントで停止しますが、すでに実行中の外部コマンド（例：PowerShell や App の起動）は、制御が引き継がれた後も続く場合があります。この制御ゲートはプロセスをキャンセルせず、完了済みの副作用を元に戻すこともありません。フックの障害が検出された場合、注入されたキーとマウスボタンは非同期に解放されるため、物理入力と、まだ押されたままの AI のキーまたはボタンが一時的に重なることがあります。また、Windows がこのプロセスに通知せずに低レベルフックを削除する場合もあります。フックを定期的に置き換えることで、この未検出の時間を減らせますが、なくすことはできません。したがって、ユーザーへの制御引き継ぎはベストエフォートであり、セキュリティ境界でも、排他的な制御を保証するものでもありません。 セッションレスの MCP 2026-07-28 クライアントは、制御状態のログを自発的に受信できません。現在の制御権の所在を確認する必要がある場合は、ControlStatus を照会してください。
• DisplayInventory：ディスプレイの配置、作業領域、有効 DPI、スケールのメタデータを読み取ります。
• Screenshot：カーソル位置、アクティブ／開いているウィンドウ、画像を含む、高速なスクリーンショット優先のデスクトップキャプチャを行います。速度を優先して UI ツリーの抽出を省略するため、主に視覚的な情報が必要な場合は、最初に呼び出すツールとして使用してください。0 から始まるアクティブな Windows ディスプレイのインデックスを使った display=[0] または display=[0,1] と、画面全体ではなく指定した四角形だけをキャプチャする region=[left, top, right, bottom]（仮想デスクトップのピクセル座標）に対応しています。どの領域が重要かすでに分かっている場合は、region を使うとトークンを節約できます。両方が指定された場合は region が display より優先されます。無効な領域、または画面範囲外の領域を指定するとエラーになります。キャプチャ後、視覚的な確認のため、キャプチャした領域の内側に短時間オレンジレッドの光る枠線が描画されます（無効にするには WINDOWS_MCP_DISABLE_FLASH=1 を設定します）。
• Snapshot：操作可能な要素 ID、スクロール可能な領域、または use_dom=True によるブラウザー抽出が必要なワークフロー向けに、デスクトップの状態をすべてキャプチャします。スクリーンショットを含める use_vision=True、0 から始まるアクティブな Windows ディスプレイのインデックスを使った display=[0] または display=[0,1]、画面全体ではなく指定した四角形だけを調べる region=[left, top, right, bottom]（仮想デスクトップのピクセル座標）に対応しています。両方が指定された場合は region が display より優先されます。無効な領域、または画面範囲外の領域を指定するとエラーになります。
• App：スタートメニュー名、または引数を分割して指定する実行ファイルのパスと任意の cwd によってアプリケーションを起動し、ウィンドウのサイズ変更、移動、切り替えを行います。
• PowerShell：PowerShell コマンドを実行します。
• FileSystem：ファイルやディレクトリの読み取り、書き込み、コピー、移動、削除、一覧表示、検索、調査を行います。
• Scrape：情報を得るため、ウェブページ全体をスクレイピングします。
• MultiSelect：複数の項目（ファイル、フォルダー、チェックボックス）を選択します。Ctrl キーの使用は任意です。ラベルが指定されている場合は、ラベルから座標への一括解決を使用します。
• MultiEdit：指定した座標にある複数の入力フィールドにテキストを入力します。ラベルが指定されている場合は、ラベルから座標への一括解決を使用します。
• Clipboard：Windows のクリップボードの読み取り、または内容の設定を行います。
• Process：実行中のプロセスを一覧表示するか、PID または名前を指定して終了します。
• Notification：タイトルとメッセージを含む Windows のトースト通知を送信します。
• Registry：Windows レジストリの値やキーの読み取り、書き込み、削除、一覧表示を行います。

🤝 コミュニティに参加する

最新情報を確認し、コミュニティに参加しましょう。

• 📢 最新ニュースや更新情報を受け取るには、X をフォローしてください

• 💬 Discord コミュニティに参加してください

スターの履歴

👥 貢献者

Windows-MCP に貢献してくださった素晴らしい皆さんに感謝します！🎉

コード、ドキュメント、バグ報告、機能の提案など、あらゆる貢献に感謝します。貢献に興味がありますか？貢献ガイドラインをご確認ください！

🔒 セキュリティ

重要：Windows-MCP はシステムへの完全なアクセス権を持ち、取り消せない操作を実行する場合があります。デプロイする前に、包括的なセキュリティガイドラインをご確認ください。

以下を含むセキュリティの詳細情報については、

• ツールごとのリスク評価
• デプロイに関する推奨事項
• 脆弱性の報告手順
• コンプライアンスおよび監査のガイドライン

セキュリティポリシーをお読みください。

📊 テレメトリー

Windows-MCP は MCP サーバーの改善に役立てるため、使用状況データを収集します。個人情報、ツールの引数、出力は追跡されません。

テレメトリーを無効にするには、MCP クライアントの設定で ANONYMIZED_TELEMETRY を false に設定してください。

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp",
        "serve"
      ],
      "env": {
        "ANONYMIZED_TELEMETRY": "false"
      }
    }
  }
}

設定可能なオプションの全一覧は、環境変数セクションをご覧ください。

収集されるデータとその取り扱いについての詳細は、セキュリティポリシーのテレメトリーとデータプライバシーセクションをご覧ください。

📝 制限事項

• MCP は a11y ツリーに依存しているため、段落内のテキストの特定の部分を選択できません。（⌛ 対応中です。）
• Type-Tool はテキスト入力用であり、IDE でのプログラミングを目的としていません。ファイル内のプログラム全体を一度に入力するためです。（⌛ 対応中です。）
• この MCP サーバーはビデオゲームのプレイには使用できません 🎮。

🪪 ライセンス

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

🙏 謝辞

Windows-MCP は、Windows の自動化機能を支える優れたオープンソースプロジェクトをいくつか利用しています。

• UIAutomation

これらのライブラリの優れた取り組みとオープンソース精神に対し、メンテナーと貢献者の皆さんに心より感謝します。

🤝貢献

貢献を歓迎します！セットアップ手順と開発ガイドラインについては、CONTRIBUTINGをご覧ください。

❤️ を込めて CursorTouch が作成しました

引用

@software{
  author       = {CursorTouch},
  title        = {Windows-MCP: Lightweight open-source project for integrating LLM agents with Windows},
  year         = {2024},
  publisher    = {GitHub},
  url={https://github.com/CursorTouch/Windows-MCP}
}