Le serveur MCP Dataform fournit des outils permettant d'interagir avec Dataform.
Un serveur MCP (Model Context Protocol) sert de proxy entre un service externe qui fournit du contexte, des données ou des capacités à un grand modèle de langage (LLM) ou à une application d'IA. Les serveurs MCP connectent les applications d'IA à des systèmes externes tels que des bases de données et des services Web, et traduisent leurs réponses dans un format que l'application d'IA peut comprendre.
Configuration du serveur
Vous devez activer les serveurs MCP et configurer l'authentification avant de les utiliser. Pour en savoir plus sur l'utilisation des serveurs MCP distants Google et Google Cloud, consultez Présentation des serveurs MCP Google Cloud.
Points de terminaison du serveur
Un point de terminaison de service MCP est l'adresse réseau et l'interface de communication (généralement une URL) du serveur MCP qu'une application d'IA (l'hôte du client MCP) utilise pour établir une connexion sécurisée et standardisée. Il s'agit du point de contact permettant au LLM de demander du contexte, d'appeler un outil ou d'accéder à une ressource. Les points de terminaison Google MCP peuvent être globaux ou régionaux.
Le serveur MCP de l'API Dataform dispose du point de terminaison MCP global suivant :
- https://dataform.googleapis.com/mcp
Outils MCP
Un outil MCP est une fonction ou une capacité exécutable qu'un serveur MCP expose à un LLM ou à une application d'IA pour effectuer une action dans le monde réel.
Outils
Le serveur MCP dataform.googleapis.com dispose des outils suivants :
| Outils MCP | |
|---|---|
list_repositories |
Lister les dépôts Dataform dans un projet et un emplacement Google Cloud donnés La valeur du paramètre |
create_repository |
Crée un dépôt Dataform dans un projet et un emplacement Google Cloud donnés. Cet outil établit la ressource racine requise pour tous les autres composants de transformation, tels que les résultats de compilation et les configurations de workflow. Vous devez créer un dépôt avant de pouvoir utiliser d'autres outils MCP Dataform. L'activation de cet outil est la première étape de la configuration d'un projet Dataform. La valeur du paramètre La valeur du paramètre Omettez le paramètre |
commit_repository_changes |
Appliquez un commit Git pour enregistrer l'état des fichiers dans un dépôt Dataform. Cet outil est principalement destiné à la gestion des composants monofichiers, tels que les notebooks ou les requêtes enregistrées, qui résident directement dans le dépôt. Cet outil n'est pas utilisé dans les workflows de pipeline standards qui nécessitent des espaces de travail. N'utilisez pas cet outil sur les dépôts connectés à un hôte Git distant. Pour vérifier, utilisez l'outil Cette action de commit crée une entrée permanente dans l'historique Git interne du dépôt. La valeur du paramètre |
read_repository_file |
Renvoie le contenu d'un fichier qui se trouve dans un dépôt Dataform. Cet outil n'est pas destiné au développement de pipelines standards. Il est destiné à l'interaction directe avec le dépôt, généralement pour gérer les composants monofichiers tels que les notebooks ou les requêtes enregistrées. N'utilisez pas cet outil sur les dépôts connectés à un hôte Git distant. Pour vérifier, utilisez l'outil La valeur du paramètre La valeur du paramètre |
query_repository_directory_contents |
Renvoie le contenu d'un répertoire de dépôt Dataform donné. Cet outil est principalement utilisé pour lister et gérer les composants monofichiers directement dans le dépôt. N'utilisez pas cet outil sur les dépôts connectés à un hôte Git distant. Pour vérifier, utilisez l'outil La valeur du paramètre La valeur du paramètre |
list_workflow_configs |
Liste les configurations de workflow dans un dépôt Dataform donné. La valeur du paramètre |
get_workflow_config |
Récupérer une seule configuration de workflow Dataform. La valeur du paramètre |
create_workflow_config |
Crée une configuration de workflow dans un dépôt Dataform donné. La valeur du paramètre
Une configuration de workflow associe un Condition préalable : Vous devez d'abord créer un Les appels de workflow créés à partir de cette configuration de workflow s'exécutent sous un compte de service personnalisé. Pour spécifier ce compte de service, définissez la valeur du paramètre |
update_workflow_config |
Mettez à jour les propriétés d'une configuration de workflow Dataform existante, telles que son calendrier d'exécution (cron), la configuration de version associée ou les remplacements d'invocation. Les modifications apportées à La valeur du paramètre La valeur du paramètre Les appels de workflow créés à partir de cette configuration de workflow s'exécutent sous un compte de service personnalisé. Pour spécifier ce compte de service, définissez la valeur du paramètre |
list_release_configs |
Répertorie les configurations de version dans un dépôt Dataform donné. La valeur du paramètre |
get_release_config |
Récupère une seule configuration de version Dataform. La valeur du paramètre |
create_release_config |
Crée une configuration de version dans un dépôt Dataform donné. La valeur du paramètre
Omettez la valeur du paramètre |
update_release_config |
Mettez à jour une configuration de version Dataform existante, qui sert de modèle pour la compilation automatique du code. Les modifications apportées à des champs tels que Omettez la valeur du paramètre La valeur du paramètre |
create_compilation_result |
Crée un résultat de compilation Dataform dans un projet et un emplacement Google Cloud donnés. Cet outil compile les fichiers La valeur du paramètre Les agents peuvent valider le code SQL compilé en inspectant les ressources Un résultat de compilation valide est requis avant de déclencher manuellement un workflow à l'aide de l'outil Prérequis : Créez un dépôt à l'aide de l'outil |
list_workflow_invocations |
Lister les invocations de workflow dans un dépôt Dataform donné. La valeur du paramètre |
create_workflow_invocation |
Crée une invocation de workflow dans un dépôt Dataform donné. La valeur du paramètre Il est obligatoire d'indiquer soit la valeur du paramètre
Condition préalable : Pour déclencher une invocation, vous devez d'abord créer un L'appel de workflow s'exécute sous un compte de service déterminé par la source de compilation :
Le compte de service ne peut pas être l'agent de service Dataform par défaut. Le compte de service doit disposer des autorisations nécessaires pour exécuter le workflow, et l'utilisateur doit être autorisé à agir en tant que compte de service sélectionné. Cette autorisation est généralement accordée par le biais du rôle Utilisateur du compte de service ( |
cancel_workflow_invocation |
Demandez l'arrêt progressif d'un appel de workflow Dataform en cours d'exécution. Cet outil envoie un signal d'annulation au workflow en cours d'exécution. Toutefois, les tâches BigQuery individuelles, les créations de tables ou les assertions qui ont déjà été effectuées dans ce workflow ne seront pas annulées. La valeur du paramètre |
get_compilation_result |
Récupérer un seul résultat de compilation Dataform. La valeur du paramètre |
query_compilation_actions |
Renvoie les actions de résultat de compilation pour un résultat de compilation Dataform donné. La valeur du paramètre |
query_workflow_invocation_actions |
Renvoie les actions d'appel de workflow pour un appel de workflow Dataform donné. Ces actions représentent les tâches BigQuery individuelles, les créations de tables ou les assertions qui composent le workflow. La valeur du paramètre |
get_workflow_invocation |
Récupérez un seul appel de workflow Dataform. La valeur du paramètre |
list_workspaces |
Répertoriez les espaces de travail de développement dans un dépôt Dataform donné. Utilisez cet outil pour découvrir les espaces de travail existants avant d'effectuer des opérations sur les fichiers (à l'aide d'outils tels que La valeur du paramètre |
get_workspace |
Récupérer un seul espace de travail de développement Dataform. La valeur du paramètre Si vous ne connaissez pas le nom exact de l'espace de travail, utilisez l'outil |
create_workspace |
Crée un espace de travail de développement dans un dépôt Dataform donné. Un espace de travail est une version isolée et modifiable du dépôt. Utilisez un espace de travail lorsque vous devez créer ou réviser du code de pipeline dans plusieurs fichiers et le valider avant de l'envoyer. Modifiez les fichiers de l'espace de travail avec les outils N'utilisez pas l'outil Prérequis : le dépôt parent doit exister. La valeur du paramètre La valeur du paramètre La valeur du paramètre |
query_directory_contents |
Renvoie le contenu d'un répertoire donné dans un espace de travail Dataform. Utilisez cet outil pour découvrir les chemins d'accès aux fichiers valides avant d'appeler les outils La valeur du paramètre La valeur de paramètre |
search_files |
Recherchez des fichiers et des répertoires dans un espace de travail Dataform qui correspondent à un filtre de recherche. Utilisez cet outil au lieu de lister les répertoires de manière récursive avec l'outil La valeur du paramètre La valeur du paramètre |
read_file |
Renvoie le contenu d'un fichier dans un espace de travail Dataform, y compris les modifications non validées. Utilisez cet outil pour lire le fichier Pour lire un fichier validé directement à partir du dépôt sans espace de travail, utilisez plutôt l'outil La valeur du paramètre La valeur de paramètre La valeur du paramètre |
write_file |
Écrivez le contenu d'un fichier dans un espace de travail Dataform, en créant le fichier s'il n'existe pas. La valeur du paramètre La valeur du paramètre La valeur de paramètre La valeur du paramètre |
remove_file |
Supprimez un fichier dans un espace de travail Dataform. La suppression reste non validée jusqu'à ce que l'outil La valeur du paramètre La valeur de paramètre |
make_directory |
Crée un répertoire dans un espace de travail Dataform, y compris les répertoires parents manquants. La valeur du paramètre La valeur de paramètre |
commit_workspace_changes |
Enregistrez un commit Git pour les modifications non validées dans un espace de travail Dataform. Le commit reste local à l'espace de travail jusqu'à ce qu'il soit publié avec l'outil Par défaut, toutes les modifications non validées sont validées. Pour n'importer qu'un sous-ensemble de fichiers, indiquez la valeur du paramètre La valeur du paramètre La valeur du paramètre La valeur du paramètre |
push_git_commits |
Transférez les modifications validées d'un espace de travail Dataform vers le dépôt Git distant. Prérequis : Vous devez valider les modifications apportées à l'espace de travail à l'aide de l'outil Si vous prévoyez d'utiliser l'outil La valeur du paramètre La valeur du paramètre |
get_repository |
Récupérez un seul dépôt Dataform, y compris ses paramètres Git distants, les remplacements de compilation de l'espace de travail et le compte de service par défaut. Utilisez cet outil pour vérifier le champ La valeur du paramètre Si vous ne connaissez pas le nom exact du dépôt, utilisez l'outil |
update_repository |
Mettez à jour les propriétés d'un dépôt Dataform existant, telles que ses paramètres Git distant, les remplacements de compilation de l'espace de travail ou le compte de service par défaut. Prérequis : Utilisez l'outil Si la valeur du paramètre La valeur du paramètre |
create_folder |
Crée un dossier Dataform dans un projet et un emplacement Google Cloud donnés. Les dossiers organisent les dépôts Dataform dans une hiérarchie. La création d'un dossier ne déplace aucun dépôt. Pour placer un dépôt dans un dossier, définissez la valeur du paramètre N'essayez pas de déplacer un dépôt existant dans un dossier à l'aide de l'outil La valeur du paramètre La valeur du paramètre |
Obtenir les spécifications de l'outil MCP
Pour obtenir les spécifications des outils MCP pour tous les outils d'un serveur MCP, utilisez la méthode tools/list. L'exemple suivant montre comment utiliser curl pour lister tous les outils et leurs spécifications actuellement disponibles sur le serveur MCP.
| Requête 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 }' |