{
  "markdown": "# Windows Management MCP Server\n\n<!-- mcp-name: io.github.ahmedlaminou/windows-mcp-server -->\n\nWindows Management MCP Server is a Python-based Model Context Protocol server for local Windows diagnostics, task management, cleanup, hardware inspection, security checks, and administrative workflows.\n\nIt exposes **96 tools** over stdio and is designed for local assistants such as Claude Desktop, Cursor, VS Code extension hosts, and other MCP-compatible clients.\n\n> Important: This server runs with the privileges of the user account that starts it. Several tools can change system state, delete files, edit the Registry, manage services, install updates, or execute PowerShell. Use the read-only and dry-run tools first, and only enable destructive actions after reviewing the target paths and commands.\n\n## Demo\n\n[![Windows Management MCP Server demo](https://img.youtube.com/vi/1GNk_GYYkww/hqdefault.jpg)](https://youtu.be/1GNk_GYYkww)\n\nWatch the demo: <https://youtu.be/1GNk_GYYkww>\n\n## What It Can Do\n\n- Task manager: CPU, GPU, memory, disk usage, top processes, process trees, process details, suspend/resume/kill.\n- Storage cleanup: disk usage, largest folders/files, duplicate detection, old files, media discovery, Recycle Bin deletion, temp cleanup.\n- Hardware and drivers: GPU details, NVIDIA `nvidia-smi` probes, display configuration, installed drivers, problem devices, driver update candidates.\n- Windows security: Defender status/scans, firewall rules, BitLocker, Secure Boot, UAC, Windows Update status.\n- System administration: services, startup apps, scheduled tasks, event logs, crash diagnostics, restore points.\n- Network diagnostics: interfaces, active sockets, listening ports, firewall correlation, ping latency.\n- Developer environment: Python/Node discovery, environment variables, common dev ports.\n- Shell helpers: Explorer open/select, screenshots, clipboard, visible windows.\n- Peripherals and virtualization: printers, print queues, audio, Bluetooth, WSL, Hyper-V, optional Windows features.\n\nFor the complete tool catalog, see [docs/TOOLS.md](docs/TOOLS.md).\n\n## Requirements\n\n- Windows 10/11 or Windows Server with PowerShell available.\n- Python 3.10 or newer.\n- Some tools require Administrator privileges or Windows features/modules that may not be installed on every machine.\n- Optional vendor data, such as NVIDIA GPU telemetry, requires vendor tools like `nvidia-smi` on `PATH`.\n\n## Installation\n\nFrom PyPI:\n\n```powershell\npip install windows-management-mcp-server\n```\n\nCreate a virtual environment and install the package in editable mode:\n\n```powershell\npython -m venv venv\n.\\venv\\Scripts\\Activate.ps1\npip install -e .\n```\n\nBoth install paths register the `windows-mcp-server` command in the active environment.\n\n## MCP Client Configuration\n\nFor clients that can launch a stdio MCP server, use:\n\n```json\n{\n  \"mcpServers\": {\n    \"windows-management\": {\n      \"command\": \"windows-mcp-server\",\n      \"args\": []\n    }\n  }\n}\n```\n\nIf the command is not on `PATH`, point directly at the local virtual environment:\n\n```json\n{\n  \"mcpServers\": {\n    \"windows-management\": {\n      \"command\": \"C:\\\\path\\\\to\\\\WindowsMCPServer\\\\venv\\\\Scripts\\\\python.exe\",\n      \"args\": [\"-m\", \"windows_mcp_server.server\"],\n      \"env\": {\n        \"PYTHONPATH\": \"C:\\\\path\\\\to\\\\WindowsMCPServer\"\n      }\n    }\n  }\n}\n```\n\n## Running Locally\n\n```powershell\nwindows-mcp-server\n```\n\nOr:\n\n```powershell\npython -m windows_mcp_server.server\n```\n\nThe server uses stdio transport and is normally launched by an MCP client rather than run interactively.\n\n## VS Code Extension\n\nThe `vscode-extension/` folder contains a small VS Code extension that launches this MCP server from the repo-local virtual environment first, then falls back to a global `windows-mcp-server`.\n\n```powershell\ncd vscode-extension\nnpm install\nnpm run compile\n```\n\nOpen `vscode-extension/` in VS Code and press `F5` to start an Extension Development Host.\n\n## Safety Model\n\nTools are intentionally mixed across read-only, safer mutation, and sharp mutation categories.\n\n- Prefer report tools first: `disk_cleanup_report`, `get_security_status`, `get_windows_update_status`, `list_scheduled_tasks`, `get_process_details`.\n- Prefer safe deletion: `safe_delete_to_recycle_bin`, `safe_delete_many_to_recycle_bin`, `safe_delete_by_pattern` with `dry_run=true`.\n- Treat these as sharp tools: `execute_powershell`, Registry writes/deletes, permanent file deletion, service changes, update installation, process termination, restore point creation.\n\nSee [docs/SECURITY_MODEL.md](docs/SECURITY_MODEL.md) before exposing this server to an assistant you do not fully trust.\n\n## Development\n\nCompile-check the Python package:\n\n```powershell\n.\\venv\\Scripts\\python.exe -m compileall windows_mcp_server\n```\n\nCheck the registered tool count:\n\n```powershell\n.\\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))\"\n```\n\nCompile the VS Code extension:\n\n```powershell\ncd vscode-extension\nnpm run compile\n```\n\n## Repository Structure\n\n```text\nwindows_mcp_server/        Python MCP server package\nwindows_mcp_server/tools/  Tool modules grouped by Windows domain\nvscode-extension/          Optional VS Code extension wrapper\ndocs/                      Tool catalog, security model, publishing guide\nserver.json                MCP Registry metadata\npyproject.toml             Python package metadata\n```\n\n## Publishing\n\nThis repository includes `server.json` for the MCP Registry and PyPI-compatible package metadata.\n\nSee [docs/PUBLISHING.md](docs/PUBLISHING.md) for the full GitHub, PyPI, and MCP Registry release flow.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n",
  "bytes": 5781,
  "sha": "6774db300f1f0fb154051dc10b0ce7406ed470eff800d2d71e1bfba78ff521bc",
  "repo_slug": "ahmedlaminou/windows-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ahmedlaminou_windows_mcp_serve_53f7f529/readme"
}