run_terminal_command

Diagnostica e sistema · macOS · Windows

Effetto: esecuzione. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Esegue un comando shell sul Mac dell'utente e restituisce il relativo output. Sempre attivo. Disabilitato quando LMCP è in modalità di sola lettura. I comandi pericolosi (sudo, eliminazioni ricorsive di percorsi di sistema/home, formattazione del disco, arresto/riavvio, reindirizzamento di uno script scaricato in una shell, bombe fork, controllo daemon) vengono rifiutati. Distruttivo: visualizza prima l'anteprima del comando — passa conferma:vero per eseguirlo effettivamente. L'output e il runtime sono limitati. Elementi tecnici invariati: confirm:true.

Input obbligatori

command

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — macOS

{
  "properties": {
    "command": {
      "description": "The shell command to run (a single command line, executed with /bin/zsh -lc).",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually run. Without it, a preview of the command is returned.",
      "type": "boolean"
    },
    "timeout_seconds": {
      "description": "Max seconds to run before it is terminated (default 20, max 60).",
      "type": "integer"
    },
    "working_dir": {
      "description": "Optional absolute working directory. Defaults to the user's home directory.",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per run_terminal_command. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "command": "echo Hello from LMCP",
  "confirm": false
}

Windows

Scopo

Esegue un comando shell sul computer dell'utente. I comandi pericolosi (escalation sudo/privilegio, eliminazioni ricorsive di percorsi di sistema o home, formattazione del disco, arresto/riavvio, reindirizzamento di uno script scaricato in una shell, bombe fork) vengono rifiutati. Distruttivo: visualizza prima l'anteprima del comando — passa conferma:vero per eseguirlo effettivamente. L'output e il runtime sono limitati. Su Windows il comando viene eseguito tramite `cmd /c`; altrove tramite `sh -c`. Elementi tecnici invariati: confirm:true.

Input obbligatori

command

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — Windows

{
  "properties": {
    "command": {
      "description": "The shell command to run (a single command line).",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually run. Without it, a preview of the command is returned.",
      "type": "boolean"
    },
    "timeout_seconds": {
      "description": "Max seconds to run before it is terminated (default 30, max 60).",
      "type": "integer"
    },
    "working_dir": {
      "description": "Optional absolute working directory. Defaults to the user's home directory.",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "type": "object"
}

Esempio documentale

{
  "command": "echo Hello from LMCP",
  "confirm": false
}