Execute a command in the specified shell (powershell, cmd, gitbash, bash, wsl)

IMPORTANT GUIDELINES:

1. ALWAYS use the workingDir parameter to specify the working directory

2. Request config of this MCP server configuration using tools

3. Follow limitations taken from configuration

4. Use validate_directories tool to validate directories before execution

Shell-Specific Settings:

powershell:

• Command timeout: 30s

• Max command length: 2000 characters

• Injection protection: enabled

• Blocked operators: &, |, ;, `

• Path format: Windows-style (C:\Users...)

cmd:

• Command timeout: 30s

• Max command length: 2000 characters

• Injection protection: enabled

• Blocked operators: &, |, ;, `

• Path format: Windows-style (C:\Users...)

gitbash:

• Command timeout: 30s

• Max command length: 2000 characters

• Injection protection: enabled

• Blocked operators: &, |, ;, `

• Path format: Mixed (C:... or /c/...)

bash:

• Command timeout: 30s

• Max command length: 2000 characters

• Injection protection: enabled

• Blocked operators: &, |, ;, `

• Path format: Unix-style (/home/user, /mnt/c/...)

wsl:

• Command timeout: 30s

• Max command length: 2000 characters

• Injection protection: enabled

• Blocked operators: &, |, ;, `

• Path format: Unix-style (/home/user, /mnt/c/...)

• Inherits global Windows paths (converted to /mnt/...)

Working Directory:

• If omitted, uses the server's current directory

• Must be within allowed paths for the selected shell

• Must use the correct format for the shell type

Output Truncation:

• Output is automatically truncated if it exceeds the configured limit

• Current limit: 20 lines

• Use maxOutputLines parameter to override the limit for a specific command

• If truncated, use get_command_output tool with the executionId to retrieve full output

• When file logging is enabled (via logDirectory), full logs are also saved to disk

Command Timeout:

• Each shell has a default command timeout (see Shell-Specific Settings above)

• Use timeout parameter to override the timeout for a specific command

• Timeout must be a positive integer between 1 and 3,600 seconds (1 hour)

• If the timeout is exceeded, the command will be terminated

Examples:

Windows CMD:

{
  "shell": "cmd",
  "command": "dir /b",
  "workingDir": "C:\\Projects"
}

WSL:

{
  "shell": "wsl",
  "command": "ls -la",
  "workingDir": "/home/user",
  "maxOutputLines": 50
}

With custom timeout:

{
  "shell": "wsl",
  "command": "long-running-command",
  "workingDir": "/home/user",
  "timeout": 120
}

Bash:

{
  "shell": "bash",
  "command": "ls -la",
  "workingDir": "/home/user",
  "maxOutputLines": 50
}

Git Bash:

{
  "shell": "gitbash",
  "command": "git status",
  "workingDir": "/c/Projects/repo"  // or "C:\Projects\repo"
}

With custom output limit:

{
  "shell": "gitbash",
  "command": "git log --oneline -50",
  "workingDir": "/c/Projects/repo",
  "maxOutputLines": 100
}

Retrieve the full output from a previous command execution.

Use this tool when command output was truncated and you need to see the complete result. The executionId is provided in the truncation message of the original command.

Parameters:

• executionId (required): The execution ID from the truncation message

• startLine (optional): 1-based start line (default: 1)

• endLine (optional): 1-based end line (default: last line)

• search (optional): Regex pattern (case-insensitive) to filter lines

• maxLines (optional): Maximum lines to return (default: config value)

Examples:

{ "executionId": "20251125-143022-a8f3" }

{ "executionId": "20251125-143022-a8f3", "startLine": 100, "endLine": 150 }

{ "executionId": "20251125-143022-a8f3", "search": "error|failed|exception" }

Get the current working directory

Set the current working directory

Get the windows CLI server configuration

Returns:

• global: Default settings applied to all shells

• shells: Enabled shells with any overrides applied

Only enabled shells are included and technical fields like executables are omitted.

Check if directories are within allowed paths (only available when restrictWorkingDirectory is enabled)

Validation Modes:

• Global: Validates against server-wide allowed paths (default)

• Shell-specific: Validates against a specific shell's allowed paths

Shell-Specific Validation: Add the "shell" parameter to validate for a specific shell:

{
  "directories": ["/home/user", "/tmp"],
  "shell": "wsl"
}