MCP Tools Reference: dataform.googleapis.com

Tool: push_git_commits

Übertragen Sie per Push-Befehl die Änderungen, die in einem Dataform-Arbeitsbereich vorgenommen wurden, an das Git-Remote des Repositorys.

Voraussetzung: Sie müssen Arbeitsbereichsänderungen mit dem Tool commit_workspace_changes committen, bevor Sie sie übertragen. Nicht übernommene Änderungen bleiben lokal und werden nicht übertragen.

Wenn Sie das create_release_config-Tool verwenden möchten, müssen Sie Ihre Commits zuerst pushen. Eine Releasekonfiguration löst ihr git_commitish im Git-Remote-Repository auf. Ein Branch oder Commit, der nur im lokalen Arbeitsbereich vorhanden ist, ist für sie also nicht sichtbar.

Der Parameterwert name muss das Format projects/{project_id}/locations/{location}/repositories/{repository}/workspaces/{workspace} haben.

Der Parameterwert remote_branch ist der Remote-Branch, in den die Änderungen übertragen werden sollen. Wird dieser Parameter weggelassen, wird ein Arbeitsbereich mit aktivierter Zweigverwaltung in den aktuell ausgecheckten Zweig übertragen und jeder andere Arbeitsbereich in den konfigurierten Standardzweig des Repositorys.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool push_git_commits aufrufen.

Curl-Anfrage 
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
}'

Eingabeschema

PushGitCommits-Anfragenachricht.

PushGitCommitsRequest

JSON-Darstellung 
{
  "name": string,
  "remoteBranch": string
}
Felder
name

string

Erforderlich. Der Name des Arbeitsbereichs.
remoteBranch

string

Optional. Der Name des Zweigs im Git-Remote-Repository, in das Commits übertragen werden sollen. Wenn diese Option nicht festgelegt ist, wird der Standardzweigname des Repositorys verwendet.

Ausgabeschema

PushGitCommits-Antwortnachricht.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet wird.

Zusammen mit dem Titelstring sind die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Einheiten interagieren. Wenn „false“, kann das Tool nur mit internen Einheiten interagieren. Ein Web-Suchtool wäre beispielsweise frei verfügbar, ein Tool für das Gedächtnis jedoch nicht.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ✅