MCP Tools Reference: dataform.googleapis.com

Strumento: make_directory

Crea una directory all'interno di un workspace Dataform, incluse le directory padre mancanti.

Il valore parametro workspace deve essere nel formato projects/{project_id}/locations/{location}/repositories/{repository}/workspaces/{workspace}.

Il valore parametro path è il percorso relativo alla directory dalla radice del workspace. Non utilizzare directory traversal, ad esempio ...

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP make_directory.

Richiesta curl 
curl --location 'https://dataform.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "make_directory",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

MakeDirectory messaggio di richiesta.

MakeDirectoryRequest

Rappresentazione JSON 
{
  "workspace": string,
  "path": string
}
Campi
workspace

string

Obbligatorio. Il nome del workspace.
path

string

Obbligatorio. Il percorso completo della directory, incluso il nome della directory, relativo alla radice dello spazio di lavoro.

Schema di output

Messaggio di risposta MakeDirectory.

Annotazioni dello strumento

Le annotazioni dello strumento vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare a un utente una richiesta di conferma.

Oltre alla stringa del titolo, sono definiti i seguenti suggerimenti booleani:

  • readOnlyHint: se è true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se è true, lo strumento può eseguire azioni distruttive. Se il valore è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se è true, chiamare ripetutamente lo strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se è true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con le entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria no.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ❌