MCP Tools Reference: dataform.googleapis.com

Tool: write_file

Schreibt den Inhalt einer Datei in einen Dataform-Arbeitsbereich und erstellt die Datei, wenn sie nicht vorhanden ist.

Der angegebene Parameterwert contents ersetzt die gesamte Datei. Lesen Sie daher die aktuellen Inhalte mit dem Tool read_file, bevor Sie eine teilweise Bearbeitung vornehmen. Änderungen werden erst übernommen, wenn das commit_workspace_changes-Tool aufgerufen wird.

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

Der Parameterwert path ist der relative Pfad zur Datei vom Arbeitsbereichsstamm aus. Verwenden Sie keine Pfadmanipulation wie ...

Der Parameterwert contents muss ein Base64-codierter String mit dem Dateiinhalt sein.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool write_file 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": "write_file",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

WriteFile-Anfragenachricht.

WriteFileRequest

JSON-Darstellung 
{
  "workspace": string,
  "path": string,
  "contents": string
}
Felder
workspace

string

Erforderlich. Der Name des Arbeitsbereichs.
path

string

Erforderlich. Die Datei.
contents

string (bytes format)

Erforderlich. Der Inhalt der Datei.

Ein base64-codierter String.

Ausgabeschema

WriteFile-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.

Destruktiver Hinweis: ✅ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ❌ | Open-World-Hinweis: ❌