Windows Management

Windows Management MCP Server

Windows Management MCP Server は、ローカルの Windows の診断、タスク管理、クリーンアップ、ハードウェア検査、セキュリティチェック、管理ワークフローに対応する、Python ベースの Model Context Protocol サーバーです。

stdio 経由で 96 個のツールを公開し、Claude Desktop、Cursor、VS Code 拡張機能のホスト、その他の MCP 対応クライアントなど、ローカルのアシスタント向けに設計されています。

重要：このサーバーは、起動したユーザーアカウントの権限で実行されます。複数のツールは、システムの状態変更、ファイルの削除、レジストリの編集、サービスの管理、更新プログラムのインストール、PowerShell の実行が可能です。まず読み取り専用ツールとドライランツールを使用し、対象パスとコマンドを確認してから、破壊的な操作を有効にしてください。

デモ

デモを見る：https://youtu.be/1GNk_GYYkww

できること

• タスクマネージャー：CPU、GPU、メモリ、ディスク使用量、上位プロセス、プロセスツリー、プロセスの詳細、一時停止／再開／終了。
• ストレージのクリーンアップ：ディスク使用量、容量の大きいフォルダー／ファイル、重複の検出、古いファイル、メディアの検出、ごみ箱の削除、一時ファイルのクリーンアップ。
• ハードウェアとドライバー：GPU の詳細、NVIDIA nvidia-smi による調査、ディスプレイ構成、インストール済みドライバー、問題のあるデバイス、ドライバー更新候補。
• Windows セキュリティ：Defender の状態／スキャン、ファイアウォールルール、BitLocker、Secure Boot、UAC、Windows Update の状態。
• システム管理：サービス、スタートアップアプリ、スケジュールされたタスク、イベントログ、クラッシュ診断、復元ポイント。
• ネットワーク診断：インターフェイス、アクティブなソケット、リスニングポート、ファイアウォールとの関連付け、ping の遅延。
• 開発環境：Python／Node の検出、環境変数、一般的な開発用ポート。
• シェルヘルパー：エクスプローラーで開く／選択する、スクリーンショット、クリップボード、表示中のウィンドウ。
• 周辺機器と仮想化：プリンター、印刷キュー、オーディオ、Bluetooth、WSL、Hyper-V、オプションの Windows 機能。

ツールの完全な一覧については、docs/TOOLS.md を参照してください。

要件

• PowerShell が利用可能な Windows 10/11 または Windows Server。
• Python 3.10 以降。
• 一部のツールでは、管理者権限、またはすべてのマシンにインストールされているとは限らない Windows の機能／モジュールが必要です。
• NVIDIA GPU のテレメトリなどの任意のベンダーデータには、PATH 上にある nvidia-smi などのベンダーツールが必要です。

インストール

PyPI から：

pip install windows-management-mcp-server

仮想環境を作成し、パッケージを編集可能モードでインストールします：

python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -e .

どちらのインストール方法でも、アクティブな環境に windows-mcp-server コマンドが登録されます。

MCP クライアントの設定

stdio MCP サーバーを起動できるクライアントでは、次の設定を使用します：

{
  "mcpServers": {
    "windows-management": {
      "command": "windows-mcp-server",
      "args": []
    }
  }
}

コマンドが PATH 上にない場合は、ローカルの仮想環境を直接指定します：

{
  "mcpServers": {
    "windows-management": {
      "command": "C:\\path\\to\\WindowsMCPServer\\venv\\Scripts\\python.exe",
      "args": ["-m", "windows_mcp_server.server"],
      "env": {
        "PYTHONPATH": "C:\\path\\to\\WindowsMCPServer"
      }
    }
  }
}

ローカルでの実行

windows-mcp-server

または：

python -m windows_mcp_server.server

このサーバーは stdio トランスポートを使用し、通常は対話形式で実行するのではなく、MCP クライアントによって起動されます。

VS Code 拡張機能

vscode-extension/ フォルダーには、この MCP サーバーをまずリポジトリ内の仮想環境から起動し、次にグローバルな windows-mcp-server にフォールバックする、小規模な VS Code 拡張機能が含まれています。

cd vscode-extension
npm install
npm run compile

VS Code で vscode-extension/ を開き、F5 を押して拡張機能開発ホストを起動します。

安全性モデル

ツールは、読み取り専用、安全性の高い変更、影響の大きい変更のカテゴリに意図的に分かれています。

• まずレポートツールを使用してください：disk_cleanup_report、get_security_status、get_windows_update_status、list_scheduled_tasks、get_process_details。
• 安全な削除を優先してください：dry_run=true を指定した safe_delete_to_recycle_bin、safe_delete_many_to_recycle_bin、safe_delete_by_pattern。
• 次のツールは影響が大きいものとして扱ってください：execute_powershell、レジストリへの書き込み／削除、ファイルの完全削除、サービスの変更、更新プログラムのインストール、プロセスの終了、復元ポイントの作成。

十分に信頼できないアシスタントにこのサーバーを公開する前に、docs/SECURITY_MODEL.md を参照してください。

開発

Python パッケージのコンパイルを確認します。

.\venv\Scripts\python.exe -m compileall windows_mcp_server

登録されているツールの数を確認します。

.\venv\Scripts\python.exe -c "from windows_mcp_server.registry import register_all_tools, registered_tools; Dummy=type('Dummy',(),{'tool':lambda self: (lambda f:f)}); register_all_tools(Dummy()); print(len(registered_tools))"

VS Code 拡張機能をコンパイルします。

cd vscode-extension
npm run compile

リポジトリの構成

windows_mcp_server/        Python MCP server package
windows_mcp_server/tools/  Tool modules grouped by Windows domain
vscode-extension/          Optional VS Code extension wrapper
docs/                      Tool catalog, security model, publishing guide
server.json                MCP Registry metadata
pyproject.toml             Python package metadata

公開

このリポジトリには、MCP Registry 用の server.json と、PyPI 互換のパッケージメタデータが含まれています。

GitHub、PyPI、MCP Registry のリリース手順の全容については、docs/PUBLISHING.md を参照してください。

ライセンス

MIT です。LICENSE を参照してください。