[Command Execution] Execute a command in the specified shell (powershell, cmd, or gitbash)

Example usage (PowerShell):

{
  "shell": "powershell",
  "command": "Get-Process | Select-Object -First 5",
  "workingDir": "C:\\Users\\username"
}

Example usage with custom environment variables:

{
  "shell": "powershell",
  "command": "python -c \"print('Hello 世界')\"",
  "env": {
    "PYTHONIOENCODING": "utf-8",
    "PYTHONUTF8": "1"
  }
}

Example usage (CMD):

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

Example usage (Git Bash):

{
  "shell": "gitbash",
  "command": "ls -la",
  "workingDir": "/c/Users/username"
}

[Command Execution] Get the history of executed commands

Example usage:

{
  "limit": 5
}

Example response:

[
  {
    "command": "Get-Process",
    "output": "...",
    "timestamp": "2024-03-20T10:30:00Z",
    "exitCode": 0
  }
]

[Command Execution] Start a command as a background job

Example usage:

{
  "shell": "powershell",
  "command": "Start-Sleep -Seconds 30; Write-Output 'Done'",
  "timeout": 60
}

Returns job ID immediately. Use get_job_status to monitor progress.

[Command Execution] Get status and metadata for a background job

Example usage:

{
  "jobId": "job_1"
}

Returns job status, runtime, exit code, and output preview (first 500 chars).

[Command Execution] Get output from a background job with streaming support

Example usage:

{
  "jobId": "job_1",
  "offset": 0
}

Returns job output. Use offset to get only new output since last call (streaming).

[Command Execution] Execute multiple commands sequentially

Example usage:

{
  "shell": "powershell",
  "commands": [
    "cd C:\\project",
    "npm install",
    "npm run build"
  ],
  "stopOnError": true,
  "timeout": 300
}

Executes commands in order. If stopOnError=true, stops on first failure.

[SSH Operations] Execute a command on a remote host via SSH

Example usage:

{
  "connectionId": "raspberry-pi",
  "command": "uname -a"
}

Configuration required in config.json:

{
  "ssh": {
    "enabled": true,
    "connections": {
      "raspberry-pi": {
        "host": "raspberrypi.local",
        "port": 22,
        "username": "pi",
        "password": "raspberry"
      }
    }
  }
}

[SSH Operations] Disconnect from an SSH server

Example usage:

{
  "connectionId": "raspberry-pi"
}

Use this to cleanly close SSH connections when they're no longer needed.

[SSH Operations] Create a new SSH connection

[SSH Operations] Read all SSH connections

[SSH Operations] Update an existing SSH connection

[SSH Operations] Delete an existing SSH connection

[SSH Operations] Get the status and health of the SSH connection pool

[SSH Operations] Validate SSH connection configuration and test connectivity

[SSH Operations] Upload file to remote host via SFTP

Example usage:

{
  "connectionId": "raspberry-pi",
  "localPath": "C:\\data\\file.txt",
  "remotePath": "/home/pi/file.txt"
}

Security: Validates local file exists. Remote path must be absolute.

[SSH Operations] Download file from remote host via SFTP

Example usage:

{
  "connectionId": "raspberry-pi",
  "remotePath": "/home/pi/file.txt",
  "localPath": "C:\\downloads\\file.txt"
}

Security: Local path must be absolute. Creates parent directories if needed.

[SSH Operations] List files and directories on remote host via SFTP

Example usage:

{
  "connectionId": "raspberry-pi",
  "remotePath": "/home/pi",
  "pattern": "*.txt"
}

Security: Remote path must be absolute. Pattern supports glob wildcards.

[SSH Operations] Delete file or directory on remote host via SFTP

Example usage:

{
  "connectionId": "raspberry-pi",
  "remotePath": "/home/pi/file.txt",
  "isDirectory": false
}

SECURITY WARNING: Deletion is permanent and cannot be undone. Remote path must be absolute. Set isDirectory=true to delete directories.

[Diagnostics] Get current security configuration including blocked commands, allowed paths, and restrictions. Use this to troubleshoot why commands are being blocked.

[Diagnostics] Test if a command would be allowed without executing it (dry-run validation). Use this to troubleshoot security blocks before attempting execution.

[Diagnostics] Explain what an exit code means and how to resolve issues

[Diagnostics] Validate configuration file and show how it merges with defaults

[Diagnostics] Get system information for troubleshooting

[Diagnostics] Test shell connectivity and basic functionality

[Diagnostics] Read a single environment variable with security filtering

Example usage:

{
  "name": "PATH",
  "show_blocked_reason": true
}

Security:

• Sensitive variables (API_KEY, PASSWORD, TOKEN, SECRET) are blocked

• Case-insensitive variable name matching

• Read-only access (no write operations)

[Diagnostics] List all accessible environment variables with optional filtering

Example usage:

{
  "filter": "^PATH|^TEMP",
  "show_blocked_count": true,
  "category": "system"
}

Security:

• Sensitive variables (API keys, passwords) automatically excluded

• Case-insensitive filtering

• Read-only access

[Diagnostics] Get a specific configuration value by path (dot notation)

Example usage:

{
  "path": "security.maxCommandLength",
  "show_type": true
}

Examples:

• "security.maxCommandLength"

• "shells.powershell.enabled"

• "ssh.strictHostKeyChecking"

[Diagnostics] Validate configuration file and preview reload (server restart required)

Example usage:

{
  "validate_before": true
}

Note: This tool validates the config file. To apply changes, restart the MCP server.

[Diagnostics] Perform DNS lookup for hostname

Example usage:

{
  "hostname": "google.com",
  "record_type": "A",
  "timeout": 5000
}

Supported record types: A, AAAA, MX, TXT, NS, CNAME, ALL

[Diagnostics] Test network connectivity to host and port

Example usage:

{
  "host": "google.com",
  "port": 443,
  "timeout": 5000
}

Security: Blocks connections to private IPs, localhost, and cloud metadata endpoints.

[System Info] Get the current working directory

[System Info] Get CPU usage percentage with configurable sampling interval

Example usage:

{
  "interval": 1000
}

Returns CPU usage percentage measured over the interval (default: 1 second).

[System Info] Get disk space information for all drives or specific drive

Example usage:

{
  "drive": "C",
  "unit": "GB"
}

Returns disk space info (total, used, free) in specified units.

[System Info] List running processes (requires opt-in configuration)

Example usage:

{
  "filter": "chrome",
  "limit": 10,
  "sort_by": "cpu"
}

SECURITY: This tool is disabled by default. Process enumeration can be used for reconnaissance. To enable, add to config.json: { "security": { "allowProcessListing": true } }