Simonb97 Win Cli MCP Server

The Windows Command - Line MCP Server provides secure command - line interaction functions, supports PowerShell, CMD, Git Bash, and SSH remote connections, and has multiple security control mechanisms.

Operating system automation Developer tools #Command - Line Tool #Security Control #Multi - Terminal Support #Remote Management .TypeScript

rating : 2.5 points

downloads : 8.7K

update time : 2025-04-29

Open Site

What is the Windows CLI MCP Server?

The Windows CLI MCP Server is a command-line tool that allows controlled access to Windows systems. It provides secure operation capabilities for local and remote systems through MCP clients (such as Claude Desktop), similar to Open Interpreter.

How to use the Windows CLI MCP Server?

By installing the specified NPM package and configuring relevant parameters, you can quickly enable this service and integrate it with the MCP client.

Applicable Scenarios

Suitable for scenarios that require secure execution of local or remote commands, such as automated operation and maintenance, development environment debugging, etc.

Main Features

Multi-Shell Support

Commands can be executed in multiple environments such as PowerShell, CMD, and Git Bash.

SSH Remote Support

It can connect to remote systems via SSH and execute commands.

Powerful Security Controls

Including functions such as command blocking, working directory verification, and maximum command length limitation.

Advantages

Powerful security control mechanisms ensure that sensitive operations are strictly managed.

Supports multiple command-line environments to meet different needs.

Flexible configuration options make it easy to adjust settings according to specific scenarios.

Limitations

Requires certain technical knowledge for correct configuration and use.

Some advanced functions may require additional learning costs.

Has high - level access permissions to system files and environment variables.

How to Use

Install the NPM Package

Run the following command in the terminal to install the required NPM package: `npx @simonb97/server-win-cli`.

Configure the Client

Add the server address and port to your MCP client configuration file.

Start the Server

Ensure that the server has been successfully started and is listening for client requests.

Usage Examples

Example 1: Local Command Execution

Send simple commands to the local server through the MCP client.

Example 2: SSH Remote Command Execution

Use SSH to connect to a remote server and execute complex tasks.

Frequently Asked Questions

How to limit the user's operation scope?

Can the SSH function be disabled?

How to view the historical command records?

Related Resources

Official Documentation

Project homepage and detailed documentation.

GitHub Code Repository

Source code and Issue tracking.

License Description

Detailed information about the MIT license.

🚀 Windows CLI Tool Documentation

This tool offers a Windows-based Command Line Interface (CLI) solution that supports multiple functions, including command execution, retrieval of command history, and remote command execution via SSH. Below are the detailed technical specifications and usage instructions.

🚀 Quick Start

Tool Overview

execute_command: Execute a command in a specified Shell environment.
get_command_history: Retrieve the history of executed commands.
ssh_execute: Execute a command on a remote device via the SSH protocol.
ssh_disconnect: Disconnect from a remote SSH server.

🔧 Technical Details

execute_command

Input Parameters:
- shell: Specify the Shell type ("powershell", "cmd", or "gitbash").
- command: The specific command to be executed.
- workingDir (optional): Specify the working directory, defaulting to the current directory.
Output:
- Successful execution: Return the output of the command.
- Execution failure: Return an error message.

get_command_history

Input Parameters:
- limit (optional number): Set the maximum number of history records to retrieve.
Output:
- Return the command history with timestamps and their corresponding output results.

ssh_execute

Input Parameters:
- connectionId: Specify the SSH connection identifier to use.
- command: The specific command to be executed on the remote device.
Output:
- Successful execution: Return the output of the command.
- Execution failure: Return an error message.

ssh_disconnect

Input Parameters:
- connectionId: Specify the SSH connection identifier to disconnect.
Output:
- Return a confirmation message indicating that the connection has been successfully disconnected.

📚 Documentation

Security Precautions

Command Control: Block specific commands based on the executable file name and full path.
Case-Insensitive: Handle commands with different cases uniformly, such as "DEL.EXE" or "del.cmd".
Intelligent Path Resolution: Prevent bypassing command restrictions by replacing paths.
Content Analysis: Avoid false alarms by analyzing command content. For example, even if "rm" is blocked, "warm_dir" can still be executed normally.
Dangerous Parameter Interception: Intercept command parameters that may pose risks.
Injection Protection: An optional feature to prevent command injection attacks.
Directory Verification: Ensure that the working directory is within the allowed path range.
Length Limit: By default, limit the length of commands.
Process Termination: Ensure that the Shell process can be terminated correctly.
Input Validation: All input must be validated before execution.
Environment Variable and File Access: Within the controlled allowed paths, it may be necessary to limit access to sensitive directories and environmental information.