MCP Tools Reference: dataform.googleapis.com

Herramienta: write_file

Escribe el contenido de un archivo dentro de un espacio de trabajo de Dataform y crea el archivo si no existe.

El valor del parámetro contents proporcionado reemplaza todo el archivo, por lo que debes leer el contenido actual con la herramienta read_file antes de realizar una edición parcial. Los cambios permanecen sin confirmar hasta que se llama a la herramienta commit_workspace_changes.

El valor del parámetro workspace debe tener el formato projects/{project_id}/locations/{location}/repositories/{repository}/workspaces/{workspace}.

El valor del parámetro path es la ruta de acceso relativa al archivo desde la raíz del espacio de trabajo. No uses la exploración de directorios, como ...

El valor del parámetro contents debe ser una cadena codificada en base64 que contenga el contenido del archivo.

En la siguiente muestra de código, se muestra cómo usar curl para llamar a la herramienta de MCP write_file.

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

Esquema de entrada

Mensaje de solicitud de WriteFile.

WriteFileRequest

Representación JSON 
{
  "workspace": string,
  "path": string,
  "contents": string
}
Campos
workspace

string

Obligatorio. Es el nombre del espacio de trabajo.
path

string

Obligatorio. El archivo.
contents

string (bytes format)

Obligatorio. Contenido del archivo

Es una cadena codificada en Base64.

Esquema de salida

Mensaje de respuesta de WriteFile.

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se le puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, se definen las siguientes sugerencias booleanas:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia destructiva: ✅ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ❌ | Sugerencia de mundo abierto: ❌