Windows CLI

Windows CLI

MCP server enabling secure command-line access to Windows shells (PowerShell, CMD, Git Bash) and SSH.

262
Stars
45
Forks
0
Releases

Overview

Windows CLI MCP Server provides an MCP server that enables secure command-line interactions on Windows, controlling access to PowerShell, CMD, Git Bash, and SSH-based remote commands. It is designed to work with MCP clients such as Claude Desktop, allowing operations on the local system while enforcing restrictions on paths, commands, and working directories. The server exposes MCP resources including SSH connections, the current working directory, and the server configuration for visibility inside clients. Its configuration is JSON-based with sections for security, shells, and SSH, supporting a default restricted configuration and an init flow to generate config files. Features include multi-shell support, remote SSH execution, and robust security controls such as blocked commands and arguments, directory restrictions, maximum command length, command logging, and simple smart validation to prevent injections. The API provides tools for executing commands, retrieving history, and managing SSH connections, along with resources exposure. The README notes the project is deprecated; consider alternatives such as DesktopCommanderMCP. Claude Desktop usage is demonstrated via claude_desktop_config.json.

Details

Owner
SimonB97
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

Multi-Shell Support

Execute commands across PowerShell, CMD, and Git Bash from MCP clients.

SSH Remote Execution

Run commands on remote systems via SSH connections.

MCP Resources Exposure

Expose SSH connections, current directory, and configuration as MCP resources.

Security Controls

Block dangerous commands and arguments, validate working directory, limit command length, log history, and enable injection protection.

Configurability and Profiles

JSON-based configuration with security, shells, and SSH sections; per-shell settings and connection profiles.

Claude Desktop Integration

Supports usage with Claude Desktop via config entries to launch the server.

Audience

MCP clientsInteract securely with local and remote shells via MCP.
Windows adminsConfigure and manage secure CLI access on Windows.
DevelopersIntegrate with Claude Desktop or similar tools for command execution.

Tags

WindowsCLIMCP serverPowerShellCMDGit BashSSHSecurityConfigurationCommand blocking