CLI MCP Server

Un server MCP (Model Context Protocol) che supporta l'esecuzione di comandi da terminale sia su PowerShell che CMD, con funzionalità di sicurezza avanzate.

Funzionalità

Strumenti Disponibili

1. add - Somma due numeri
2. powershell - Esegue comandi PowerShell
3. cmd - Esegue comandi CMD
4. shell - Esegue comandi shell (auto-rileva il sistema operativo)
5. system-info - Mostra informazioni sul sistema
6. security-config - Mostra la configurazione di sicurezza corrente

Configurazione di Sicurezza

Il server supporta un sistema di configurazione avanzato per limitare l'accesso e i comandi disponibili.

File di Configurazione

Crea un file config.json nella directory root del progetto per personalizzare la configurazione:

{
  "security": {
    "allowedPartitions": [
      "C:\\Users\\",
      "D:\\Projects\\",
      "E:\\Development\\"
    ],
    "defaultPath": "C:\\Users\\",
    "blockedCommands": [
      "rm",
      "rmdir", 
      "del",
      "format",
      "fdisk",
      "diskpart",
      "shutdown",
      "reboot",
      "restart",
      "halt",
      "poweroff",
      "net user",
      "net localgroup",
      "adduser",
      "deluser",
      "passwd",
      "chpasswd",
      "sudo",
      "su",
      "runas",
      "reg delete",
      "reg add",
      "regedit",
      "gpedit",
      "sc delete",
      "sc create",
      "sc config",
      "taskkill",
      "wmic",
      "powercfg",
      "bcdedit"
    ],
    "allowedCommandPatterns": [
      "^(ls|dir|cd|pwd|echo|cat|type|find|grep|head|tail|sort|wc)\\b",
      "^(git|npm|node|python|pip)\\b",
      "^(Get-|Set-|New-|Remove-).*(Process|Service|Item|Content|Location)\\b"
    ],
    "maxCommandLength": 500,
    "timeoutSeconds": 30,
    "allowNetworkCommands": false
  }
}

Opzioni di Configurazione

allowedPartitions

• Array di percorsi consentiti per l'esecuzione dei comandi
• Se vuoto, tutti i percorsi sono consentiti
• Esempio: ["C:\\Users\\", "D:\\Projects\\"]

defaultPath

• Percorso predefinito utilizzato quando non viene specificato un workingDirectory
• Default: directory corrente del processo
• Esempio: "C:\\Users\\"

blockedCommands

• Array di comandi o parole chiave bloccati
• Controlla se il comando contiene queste parole
• Esempio: ["rm", "del", "format", "shutdown"]

allowedCommandPatterns

• Array di pattern regex per comandi consentiti
• Se definito, solo i comandi che corrispondono ai pattern sono permessi
• Esempio: ["^(ls|dir|cd)\\b", "^git\\b"]

maxCommandLength

• Lunghezza massima consentita per i comandi
• Default: 500 caratteri

timeoutSeconds

• Timeout per l'esecuzione dei comandi
• Default: 30 secondi

allowNetworkCommands

• Permette o blocca comandi di rete (curl, wget, ping, etc.)
• Default: false

Esempi di Utilizzo

Configurazione MCP Client

Per configurare un client MCP, usa questa configurazione:

{
  "mcpServers": {
    "cli-mcp-server": {
      "command": "node",
      "args": ["path/to/cli-mcp/index.js"],
      "cwd": "path/to/cli-mcp",
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Strumento PowerShell

Esegue comandi PowerShell specifici con controlli di sicurezza.

Parametri:

• command (obbligatorio): Comando PowerShell da eseguire
• workingDirectory (opzionale): Directory di lavoro per l'esecuzione

Esempio:

{
  "command": "Get-Process | Select-Object -First 5",
  "workingDirectory": "C:\\Users"
}

Strumento CMD

Esegue comandi CMD specifici con controlli di sicurezza.

Parametri:

• command (obbligatorio): Comando CMD da eseguire
• workingDirectory (opzionale): Directory di lavoro per l'esecuzione

Esempio:

{
  "command": "dir /b",
  "workingDirectory": "C:\\Windows"
}

Strumento Shell

Esegue comandi shell con rilevamento automatico del sistema operativo e controlli di sicurezza.

Parametri:

• command (obbligatorio): Comando shell da eseguire
• workingDirectory (opzionale): Directory di lavoro per l'esecuzione
• shell (opzionale): Shell specifico da usare ("auto", "powershell", "cmd", "bash")

Esempio:

{
  "command": "ls -la",
  "shell": "bash"
}

Strumento Security Config

Mostra la configurazione di sicurezza corrente del server.

Parametri: Nessuno

Sicurezza

• Tutti i comandi hanno un timeout configurabile (default: 30 secondi)
• I comandi PowerShell vengono sanitizzati per evitare injection
• La directory di lavoro può essere specificata e viene controllata
• Sistema di blocco comandi basato su parole chiave
• Controllo accesso partizioni/directory
• Limite lunghezza comandi
• Pattern regex per comandi consentiti
• Blocco opzionale comandi di rete

Utilizzo

1. Crea un file di configurazione config.json (opzionale)
2. Avvia il server:

node index.js

3. Il server si metterà in ascolto su stdin/stdout per comunicazioni MCP

Installazione

npm install

Configurazione di Esempio

Copia config.example.json in config.json e personalizza secondo le tue esigenze:

cp config.example.json config.json

Requisiti

• Node.js v16 o superiore
• Windows (per PowerShell e CMD) o Linux/macOS (per bash)

Dipendenze

• @modelcontextprotocol/sdk: SDK per server MCP
• child_process: Modulo built-in di Node.js per esecuzione comandi
• os: Modulo built-in di Node.js per informazioni sistema
• path: Modulo built-in di Node.js per gestione percorsi
• fs: Modulo built-in di Node.js per accesso file system

Messaggi di Sicurezza

Il server mostra messaggi chiari quando un comando viene bloccato:

• ❌ Command blocked: [motivo] - Comando bloccato dalle regole di sicurezza
• ❌ Path access denied: [motivo] - Accesso negato al percorso specificato
• ⚠️ No config.json found, using default configuration - Configurazione predefinita in uso
• ✅ Configuration loaded from config.json - Configurazione caricata correttamente