Skip to main content
Glama
delorenj

Super Windows CLI MCP Server

by delorenj
README.md
# Super Windows CLI MCP Server

An enhanced fork of the Windows CLI MCP Server with unrestricted system access capabilities.

## Enhancements

- Full system access through SYSTEM service installation
- Unrestricted command execution
- Network-level access controls
- Unlimited process capabilities
- Auto-recovery and fault tolerance
- PowerShell telemetry disabled

## Security Notice

This version removes application-level restrictions in favor of network-level security. It is designed for use in trusted environments where full system access is required.

## Features

- Complete access to Windows shell environments (PowerShell, CMD, Git Bash)
- No command or argument restrictions
- Full file system access
- SYSTEM-level service installation
- Automatic service recovery
- Network binding controls
- Process reuse for performance
- Extended timeouts for long-running operations

## Installation

1. Build the project:
```bash
npm install
npm run build
```

2. Copy the built files to your Windows machine

3. Run the installation script as administrator:
```powershell
.\install-service.ps1
```

## Configuration

The server is configured for maximum capability with these key features:

- No command restrictions
- Full filesystem access
- Disabled injection protection
- Unlimited process resources
- Network-level access control
- SYSTEM-level privileges

See `config.json` for the complete configuration.

## Service Management

### Installation
```powershell
.\install-service.ps1
```

### Removal
```powershell
.\uninstall-service.ps1
```

## Network Security

While application-level restrictions are removed, the following network-level protections are in place:

- Localhost binding by default
- Configurable allowed IP ranges
- Local network restriction
- Optional VPN integration

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Acknowledgments

Based on the original [win-cli-mcp-server](https://github.com/SimonB97/win-cli-mcp-server) by SimonB97.

TDQS

B3.1/5.0

Scored across 4 tools

Disambiguation3/5

The tools have some overlap in purpose that could cause confusion. execute_command and ssh_execute both execute commands but in different contexts (local vs remote), which might lead to misselection if the agent doesn't carefully distinguish between local and remote execution. However, get_command_history and ssh_disconnect are clearly distinct from the execution tools.

Naming Consistency4/5

The naming follows a mostly consistent verb_noun pattern with clear actions like execute, get, and disconnect. All tools use snake_case consistently. The minor deviation is that ssh_disconnect uses 'disconnect' while others use more specific verbs, but overall it's readable and predictable.

Tool Count3/5

With only 4 tools, the count feels borderline thin for a 'Super Windows CLI MCP Server' that implies broader command-line capabilities. It covers basic execution and SSH operations but lacks tools for file management, process control, or other common CLI tasks, making the scope seem underdeveloped.

Completeness2/5

There are significant gaps in the tool surface for a Windows CLI server. It includes command execution and SSH operations but misses core functionalities like file operations (e.g., copy, move, delete), process management (e.g., start, stop), system information retrieval, or network utilities. The SSH tools are incomplete without a corresponding ssh_connect tool to establish connections.

Maintenance

ActivityInactive
ResponsivenessNo issues