Skip to main content
Glama
Windows Server MCP

Windows Server MCP

πŸͺŸ Windows Server MCP

Let your AI assistant inspect, diagnose and manage your Windows PC: 100 tools, local, over stdio.

English EspaΓ±ol

CI PyPI License MIT Python Windows Tools

Telegram YouTube Website


Windows Server MCP is a Model Context Protocol server with 100 tools for local Windows diagnostics, cleanup, hardware, security and administration. It works with Claude Desktop, Cursor, VS Code and any MCP client, and nothing leaves your PC.

IMPORTANT

The server runs with the privileges of the account that starts it. Some tools can delete files, edit the Registry, manage services or run PowerShell.Start with the read-only and dry-run tools.

πŸš€ Install

pip install windows-server-mcp

Requires Windows 10/11/Server and Python 3.10+. From source: git clone https://github.com/AstraxOf/windows-server-mcp.git, then pip install -e ..

Related MCP server: winfolio

πŸ”Œ Connect your client

Add this to your MCP client config (Claude Desktop: claude_desktop_config.json):

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

If the command isn't on your PATH, use "command": "C:\\path\\to\\python.exe" with "args": ["-m", "windows_server_mcp.server"].

πŸ› οΈ What it can do

Area

Examples

πŸ“Š Task manager

CPU, GPU, memory, disk, processes, suspend / resume / kill

🧹 Storage

Largest files, duplicates, old files, Recycle Bin cleanup

πŸ–₯️ Hardware

GPU, nvidia-smi, displays, drivers, thermals, battery

πŸ›‘οΈ Security

Defender, firewall, BitLocker, Secure Boot, Windows Update

βš™οΈ Admin

Services, startup items, scheduled tasks, event logs, restore points

🌐 Network

Interfaces, ports, latency, firewall rules

πŸ‘©β€πŸ’» Dev & shell

Python/Node, env vars, clipboard, screenshots, PowerShell

Full list in docs/TOOLS.md.

πŸ” Safety

Level

Examples

🟒 Read-only

disk_cleanup_report, get_security_status, list_scheduled_tasks

🟑 Previewable

safe_delete_by_pattern (dry_run=true), Recycle Bin deletes

πŸ”΄ Sharp

execute_powershell, Registry writes, service changes, kill process

See docs/SECURITY_MODEL.md before using it with an assistant you don't fully trust.

🩺 Troubleshooting

Symptom

Fix

windows-server-mcp is not recognized

Activate your venv, or use python -m windows_server_mcp.server.

A tool says access denied

It needs an elevated terminal. Only elevate if you trust the client.

The client shows no tools

Restart it completely and check its MCP logs (%LOCALAPPDATA%\windows-server-mcp\server.log).

πŸ§‘β€πŸ’» Development

pip install -e . pytest
python -m pytest -q tests

See CONTRIBUTING.md, docs/DEVELOPMENT.md and docs/PUBLISHING.md. Report security issues privately via SECURITY.md.

Telegram Channel YouTube Email

πŸ™ Credits & License

Built on the original work of Ahmed Laminou Amadou, the original author and maintainer. Maintained by Rufus Β· @AstraxOf Β· astrabots.pro.

MIT License Β· Copyright Β© 2026 Ahmed Laminou Amadou

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to control Windows systems through natural language commands, providing 200+ automation tools for system control, file operations, web automation, and more.
      61
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to perform comprehensive Windows system health diagnostics, security checks, developer workflows, and maintenance tasks via 85 tools with actionable recommendations, over MCP and OpenAI-compatible HTTP.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to operate and monitor Windows workspaces through native tools for filesystem operations, PowerShell execution, background tasks, Windows services, GPU telemetry, PDF generation, and a built-in web gateway/dashboard.
      24 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI to see and drive any Windows application through the accessibility tree - reading real element names, states and actions and invoking the app's own controls without screenshots or moving the mouse, even for windows behind others. Also exposes 200+ native Windows tools for system health, hardware, network, privacy, files, processes, registry, media and more.
      3
      Apache 2.0