El servidor de MCP de Dataform proporciona herramientas para interactuar con Dataform.
Un servidor del Protocolo de contexto del modelo (MCP) actúa como proxy entre un servicio externo que proporciona contexto, datos o capacidades a un modelo de lenguaje grande (LLM) o una aplicación de IA. Los servidores de MCP conectan las aplicaciones de IA a sistemas externos, como bases de datos y servicios web, y traducen sus respuestas a un formato que la aplicación de IA pueda comprender.
Configuración del servidor
Antes de usar los servidores de MCP, debes habilitarlos y configurar la autenticación. Para obtener más información sobre el uso de los servidores de MCP remotos de Google y Google Cloud, consulta la Descripción general de los servidores de MCP de Google Cloud.
Extremos del servidor
Un extremo de servicio de MCP es la dirección de red y la interfaz de comunicación (por lo general, una URL) del servidor de MCP que usa una aplicación de IA (el host para el cliente de MCP) para establecer una conexión segura y estandarizada. Es el punto de contacto para que el LLM solicite contexto, llame a una herramienta o acceda a un recurso. Los extremos de MCP de Google pueden ser globales o regionales.
El servidor de MCP de la API de Dataform tiene el siguiente extremo de MCP global:
- https://dataform.googleapis.com/mcp
Herramientas de MCP
Una herramienta de MCP es una función o capacidad ejecutable que un servidor de MCP expone a un LLM o a una aplicación de IA para realizar una acción en el mundo real.
Herramientas
El servidor de MCP de dataform.googleapis.com tiene las siguientes herramientas:
| Herramientas de MCP | |
|---|---|
list_repositories |
Enumera los repositorios de Dataform en una ubicación y un proyecto de Google Cloud determinados. El valor del parámetro |
create_repository |
Crea un repositorio de Dataform nuevo en un proyecto y una ubicación determinados de Google Cloud. Esta herramienta establece el recurso raíz necesario para todos los demás recursos de transformación, como los resultados de la compilación y la configuración del flujo de trabajo. Se debe crear un repositorio antes de poder usar cualquier otra herramienta de MCP de Dataform. Habilitar esta herramienta es el primer paso para configurar un proyecto de Dataform. El valor del parámetro El valor del parámetro Omite el parámetro |
commit_repository_changes |
Aplica una confirmación de Git para registrar el estado de los archivos dentro de un repositorio de Dataform. Esta herramienta está diseñada principalmente para administrar recursos de un solo archivo, como notebooks o consultas guardadas, que residen directamente en el repositorio. Esta herramienta no se usa en los flujos de trabajo típicos de canalizaciones que requieren espacios de trabajo. No uses esta herramienta en repositorios conectados a un host de Git remoto. Para verificarlo, usa la herramienta de Esta acción de confirmación crea una entrada permanente en el historial interno de Git del repositorio. El valor del parámetro |
read_repository_file |
Devuelve el contenido de un archivo que se encuentra dentro de un repositorio de Dataform. Esta herramienta no es para el desarrollo de canalizaciones estándar. Está diseñado para la interacción directa con el repositorio, por lo general, para administrar recursos de un solo archivo, como notebooks o consultas guardadas. No uses esta herramienta en repositorios conectados a un host de Git remoto. Para verificarlo, usa la herramienta de El valor del parámetro El valor del parámetro |
query_repository_directory_contents |
Devuelve el contenido de un directorio de repositorio de Dataform determinado. Esta herramienta se usa principalmente para enumerar y administrar activos de un solo archivo directamente en el repositorio. No uses esta herramienta en repositorios conectados a un host de Git remoto. Para verificarlo, usa la herramienta de El valor del parámetro El valor del parámetro |
list_workflow_configs |
Enumera las configuraciones del flujo de trabajo en un repositorio de Dataform determinado. El valor del parámetro |
get_workflow_config |
Recupera la configuración de un solo flujo de trabajo de Dataform. El valor del parámetro |
create_workflow_config |
Crea una configuración de flujo de trabajo nueva en un repositorio de Dataform determinado. El valor del parámetro El Una configuración de flujo de trabajo vincula un Requisito previo: Primero debes crear un Las invocaciones de flujo de trabajo creadas a partir de esta configuración se ejecutan con una cuenta de servicio personalizada. Para especificar esta cuenta de servicio, establece el valor del parámetro |
update_workflow_config |
Actualiza las propiedades de un parámetro de configuración de flujo de trabajo de Dataform existente, como su programa de ejecución (cron), el parámetro de configuración de lanzamiento asociado o las anulaciones de invocación. Las modificaciones en El valor del parámetro El valor del parámetro Las invocaciones de flujo de trabajo creadas a partir de esta configuración se ejecutan con una cuenta de servicio personalizada. Para especificar esta cuenta de servicio, establece el valor del parámetro |
list_release_configs |
Enumera las configuraciones de lanzamiento en un repositorio de Dataform determinado. El valor del parámetro |
get_release_config |
Recupera una sola configuración de lanzamiento de Dataform. El valor del parámetro |
create_release_config |
Crea una nueva configuración de versión en un repositorio de Dataform determinado. El valor del parámetro
Omite el valor del parámetro |
update_release_config |
Actualiza una configuración de versión de Dataform existente, que sirve como plantilla para la compilación automática de código. Las actualizaciones de campos como Omite el valor del parámetro El valor del parámetro |
create_compilation_result |
Crea un nuevo resultado de compilación de Dataform en un proyecto y una ubicación determinados de Google Cloud. Esta herramienta compila archivos El valor del parámetro Los agentes pueden validar el SQL compilado inspeccionando los recursos de Se requiere un resultado de compilación válido antes de activar una invocación de flujo de trabajo manual con la herramienta Requisito previo: Crea un repositorio con la herramienta |
list_workflow_invocations |
Enumera las invocaciones de flujo de trabajo en un repositorio de Dataform determinado. El valor del parámetro |
create_workflow_invocation |
Crea una nueva invocación de flujo de trabajo en un repositorio de Dataform determinado. El valor del parámetro Se requiere el valor del parámetro
Requisito previo: Para activar una invocación, primero debes crear un La invocación del flujo de trabajo se ejecuta con una cuenta de servicio determinada por la fuente de compilación:
La cuenta de servicio no puede ser el agente de servicio predeterminado de Dataform. La cuenta de servicio debe tener los permisos necesarios para ejecutar el flujo de trabajo, y el usuario debe estar autorizado para actuar como la cuenta de servicio seleccionada. Por lo general, esta autorización se otorga a través del rol de usuario de cuenta de servicio ( |
cancel_workflow_invocation |
Solicita la finalización ordenada de una invocación de flujo de trabajo de Dataform en ejecución. Esta herramienta envía un indicador de cancelación al flujo de trabajo en ejecución. Sin embargo, no se revertirán los trabajos individuales de BigQuery, las creaciones de tablas ni las aserciones que ya se hayan completado como parte de este flujo de trabajo. El valor del parámetro |
get_compilation_result |
Recupera un solo resultado de compilación de Dataform. El valor del parámetro |
query_compilation_actions |
Devuelve las acciones del resultado de compilación para un resultado de compilación de Dataform determinado. El valor del parámetro |
query_workflow_invocation_actions |
Devuelve las acciones de invocación del flujo de trabajo para una invocación de flujo de trabajo de Dataform determinada. Estas acciones representan los trabajos individuales de BigQuery, las creaciones de tablas o las aserciones que componen el flujo de trabajo. El valor del parámetro |
get_workflow_invocation |
Recupera una sola invocación de flujo de trabajo de Dataform. El valor del parámetro |
list_workspaces |
Enumera los lugares de trabajo de desarrollo en un repositorio de Dataform determinado. Usa esta herramienta para descubrir los espacios de trabajo existentes antes de realizar operaciones con archivos (con herramientas como El valor del parámetro |
get_workspace |
Recupera un solo espacio de trabajo de desarrollo de Dataform. El valor del parámetro Si no conoces el nombre exacto del espacio de trabajo, usa la herramienta |
create_workspace |
Crea un nuevo espacio de trabajo de desarrollo en un repositorio de Dataform determinado. Un espacio de trabajo es una copia aislada y editable del repositorio. Usa un espacio de trabajo cuando necesites crear o revisar código de canalización en varios archivos y validarlo antes de confirmarlo. Edita archivos en el espacio de trabajo con las herramientas No uses la herramienta Requisito previo: Debe existir el repositorio principal. El valor del parámetro El valor del parámetro El valor del parámetro |
query_directory_contents |
Devuelve el contenido de un directorio determinado dentro de un espacio de trabajo de Dataform. Usa esta herramienta para descubrir rutas de acceso de archivos válidas antes de llamar a las herramientas El valor del parámetro El valor del parámetro |
search_files |
Busca archivos y directorios en un espacio de trabajo de Dataform que coincidan con un filtro de búsqueda. Usa esta herramienta en lugar de enumerar directorios de forma recursiva con la herramienta El valor del parámetro El valor del parámetro |
read_file |
Devuelve el contenido de un archivo dentro de un lugar de trabajo de Dataform, incluidos los cambios no confirmados. Usa esta herramienta para leer el archivo Para leer un archivo confirmado directamente desde el repositorio sin un espacio de trabajo, usa la herramienta El valor del parámetro El valor del parámetro El valor del parámetro |
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 El valor del parámetro El valor del parámetro El valor del parámetro |
remove_file |
Borra un archivo dentro de un espacio de trabajo de Dataform. El borrado no se confirma hasta que se llama a la herramienta El valor del parámetro El valor del parámetro |
make_directory |
Crea un directorio dentro de un espacio de trabajo de Dataform, incluidos los directorios principales faltantes. El valor del parámetro El valor del parámetro |
commit_workspace_changes |
Registra una confirmación de Git para los cambios no confirmados en un espacio de trabajo de Dataform. La confirmación permanece local en el espacio de trabajo hasta que se publica con la herramienta De forma predeterminada, se confirman todos los cambios sin confirmar. Para confirmar solo un subconjunto de archivos, proporciona el valor del parámetro El valor del parámetro El valor del parámetro El valor del parámetro |
push_git_commits |
Envía los cambios confirmados de un espacio de trabajo de Dataform al repositorio remoto de Git. Requisito previo: Debes confirmar las ediciones del espacio de trabajo con la herramienta Si planeas usar la herramienta El valor del parámetro El valor del parámetro |
get_repository |
Recupera un solo repositorio de Dataform, incluidos sus parámetros de configuración remotos de Git, las anulaciones de compilación del espacio de trabajo y la cuenta de servicio predeterminada. Usa esta herramienta para verificar el campo El valor del parámetro Si no conoces el nombre exacto del repositorio, usa la herramienta |
update_repository |
Actualiza las propiedades de un repositorio de Dataform existente, como la configuración remota de Git, las anulaciones de compilación del espacio de trabajo o la cuenta de servicio predeterminada. Requisito previo: Usa la herramienta Si se omite el valor del parámetro El valor del parámetro |
create_folder |
Crea una carpeta de Dataform nueva en un proyecto y una ubicación determinados de Google Cloud. Las carpetas organizan los repositorios de Dataform en una jerarquía. La creación de una carpeta no mueve ningún repositorio a ella. Para colocar un repositorio dentro de una carpeta, establece el valor del parámetro No intentes mover un repositorio existente a una carpeta con la herramienta El valor del parámetro El valor del parámetro |
Obtén las especificaciones de la herramienta de MCP
Para obtener las especificaciones de las herramientas de MCP para todas las herramientas en un servidor de MCP, usa el método tools/list. En el siguiente ejemplo, se muestra cómo usar curl para enumerar todas las herramientas y sus especificaciones disponibles actualmente en el servidor de MCP.
| 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/list", "jsonrpc": "2.0", "id": 1 }' |