MCP Tools Reference: dataform.googleapis.com

Strumento: push_git_commits

Esegui il push delle modifiche di cui è stato eseguito il commit di un workspace Dataform nel git remote del repository.

Prerequisito: devi eseguire il commit delle modifiche allo spazio di lavoro utilizzando lo strumento commit_workspace_changes prima di eseguire il push. Le modifiche non eseguite rimangono locali e non vengono inviate.

Se prevedi di utilizzare lo strumento create_release_config, devi prima eseguire il push dei commit. Una configurazione della release risolve il relativo git_commitish rispetto al repository Git remoto, quindi un ramo o un commit che esiste solo nello spazio di lavoro locale non è visibile.

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

Il valore parametro remote_branch è il ramo remoto a cui eseguire il push. Se omesso, un workspace con la gestione dei branch abilitata esegue il push nel branch attualmente estratto e qualsiasi altro workspace esegue il push nel branch predefinito configurato del repository.

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

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": "push_git_commits",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

PushGitCommits messaggio di richiesta.

PushGitCommitsRequest

Rappresentazione JSON 
{
  "name": string,
  "remoteBranch": string
}
Campi
name

string

Obbligatorio. Il nome del workspace.
remoteBranch

string

Facoltativo. Il nome del ramo nel repository Git remoto a cui devono essere inviati i commit. Se non viene impostato, verrà utilizzato il nome del ramo predefinito del repository.

Schema di output

Messaggio di risposta PushGitCommits.

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: ✅