This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Let your AI assistant inspect, diagnose and manage your Windows PC through the Model Context Protocol: 97 tools, local, over stdio.
Windows Management MCP Server is a Python server for the Model Context Protocol that exposes 97 tools for local Windows diagnostics, task management, cleanup, hardware inspection, security checks and administration. It works with Claude Desktop, Cursor, VS Code and any other MCP-compatible client.
This server runs with the privileges of the account that starts it. Some tools can delete files, edit the Registry, manage services, install updates or run PowerShell.Start with the read-only and dry-run tools and only allow destructive actions after reviewing the target paths and commands.
Credits. This project was created by Ahmed Laminou Amadou (@AhmedLaminou), the original author and maintainer: the architecture and the original 96 tools are his work. This version updates it to keep it running with the new MCP Python SDK and adds one small tool (see What's new).
Jump to: What's new · Install · Connect a client · What it can do · Safety · Troubleshooting · Credits
The official MCP Python SDK v2.0.0 (July 28, 2026) renamed FastMCP to MCPServer and moved the module from mcp.server.fastmcp to mcp.server.mcpserver, with no deprecation shim. Since pip install mcp now installs 2.x, a fresh install of the old code crashed on start-up with ModuleNotFoundError.
Change | Detail |
✅ Works with | Uses |
✅ Still works with | Falls back to |
🧹 Unused dependency removed | The standalone |
🔒 Safer version range |
|
🎁 New tool |
|
🧪 Tests + CI | Import, tool-count and |
📝 Docs | New English and Spanish READMEs. |
💡 Not the same thing: the standalone
fastmcpframework was not renamed. Only the class built into the officialmcpSDK was.
Full details in the CHANGELOG.
Related MCP server: PC Controller MCP Server
flowchart LR
A["🤖 AI client<br/>Claude Desktop · Cursor · VS Code"] <-->|"MCP over stdio"| B["🪟 windows-mcp-server<br/>(Python)"]
B <--> C["⚙️ PowerShell · psutil · Windows APIs"]Your MCP client launches windows-mcp-server as a local process.
The assistant sees the 97 tools and decides which one to call.
The server runs it on your PC and returns the result. Nothing is sent to third-party servers.
Requirement | Notes |
Windows 10 / 11 / Server with PowerShell | Check with |
Python 3.10 or newer |
|
An MCP client | Claude Desktop, Cursor, VS Code, etc. |
Some tools need Administrator privileges or optional Windows features. NVIDIA telemetry needs nvidia-smi on your PATH.
From PyPI:
pip install windows-management-mcp-serverFrom source (recommended if you want to modify it):
git clone https://github.com/AhmedLaminou/windows-mcp-server.git
cd windows-mcp-server
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -e .Both options register the windows-mcp-server command in the active environment.
Add this to your client's MCP configuration (for Claude Desktop: claude_desktop_config.json):
{
"mcpServers": {
"windows-management": {
"command": "windows-mcp-server",
"args": []
}
}
}If the command isn't on your PATH, point to the virtual environment:
{
"mcpServers": {
"windows-management": {
"command": "C:\\path\\to\\windows-mcp-server\\venv\\Scripts\\python.exe",
"args": ["-m", "windows_mcp_server.server"]
}
}
}You can also run it by hand (windows-mcp-server or python -m windows_mcp_server.server), but it speaks stdio, so it's meant to be launched by a client.
VS Code: the vscode-extension/ folder contains a small extension that launches the server (repo-local venv first, then the global command). Run npm install && npm run compile, open the folder in VS Code and press F5.
Area | Examples |
📊 Task manager | CPU, GPU, memory, disk, top processes, process trees, suspend / resume / kill. |
🧹 Storage & cleanup | Largest folders and files, duplicates, old files, media, Recycle Bin deletion, temp cleanup. |
🖥️ Hardware & drivers | GPU info, |
🛡️ Security | Defender status/scans, firewall rules, BitLocker, Secure Boot, UAC, Windows Update. |
⚙️ Administration | Services, startup apps, scheduled tasks, event logs, crash diagnostics, restore points. |
🌐 Network | Interfaces, sockets, listening ports, firewall correlation, ping latency. |
👩💻 Developer env | Python/Node discovery, environment variables, common dev ports. |
🪟 Shell helpers | Explorer open/select, screenshots, clipboard, visible windows. |
🔌 Peripherals & virtualization | Printers, audio, Bluetooth, WSL, Hyper-V, optional Windows features. |
The complete list is in docs/TOOLS.md.
🎬 Original demo: https://youtu.be/1GNk_GYYkww
Level | Examples | Advice |
🟢 Read-only |
| Use these first. |
🟡 Safer mutation |
| Reversible or previewable. |
🔴 Sharp tools |
| Review every call. Don't run as Administrator unless needed. |
Treat the MCP client as part of the trusted computing base. See docs/SECURITY_MODEL.md before exposing this server to an assistant you don't fully trust.
Symptom | Fix |
| You're on an old copy of this project with |
| Activate the virtual environment, or use the |
| Reinstall Python ticking Add Python to PATH, or try |
A tool says access denied | It needs an elevated terminal / Administrator. Only elevate if you trust the client. |
| Install the NVIDIA driver tools and make sure |
The client doesn't show the tools | Restart the client completely and check its MCP logs. |
pip install -e . pytest
python -m pytest -q tests # imports + 97 tools registered
python -m compileall windows_mcp_server # compile checkThe tests also run on Linux/macOS (no tool is executed). See docs/DEVELOPMENT.md to add a tool and CONTRIBUTING.md for the pull-request checklist.
windows_mcp_server/ Python MCP server package
windows_mcp_server/tools/ Tool modules grouped by Windows domain
tests/ Registration and import tests
vscode-extension/ Optional VS Code extension wrapper
docs/ Tool catalog, security model, publishing guide
server.json MCP Registry metadataIssues and pull requests are welcome. Please read CONTRIBUTING.md and the Code of Conduct, and report security problems privately following SECURITY.md (never in a public issue).
Original author and maintainer: Ahmed Laminou Amadou · AhmedLaminou/windows-mcp-server
Compatibility update for MCP SDK 2.x and get_server_status: Rufus · @AstraxOf · astrabots.pro
If this project is useful to you, leave a ⭐ on the original repository and join the Telegram channel.
Made with 💙 by Rufus · @AstraxOf · astrabots.pro
MIT License · Copyright © 2026 Ahmed Laminou Amadou
This server cannot be deployed
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.