Cette page documente les outils exposés par le serveur MCP DataGalaxy, avec leurs paramètres et des notes d'utilisation. Le serveur expose 15 outils pour définir le périmètre, rechercher dans le catalogue, lire les objets et leurs relations, lire et rédiger des commentaires, mettre à jour des attributs, et consulter les utilisateurs, tags, technologies et sources de données.
Tous les outils respectent les droits du compte DataGalaxy utilisé pour la connexion : l'assistant ne voit et ne modifie que ce que ce compte peut voir et modifier.
Vue d'ensemble
| Outil | Rôle | Accès |
|---|---|---|
| list_workspaces_and_versions | Déterminer l'espace de travail et la version | Lecture |
| search_objects | Rechercher par nom, type, module, dates et tout attribut ou relation filtrable | Lecture |
| list_filterable_attributes | Obtenir les clés, opérateurs et valeurs exacts des filtres de search_objects | Lecture |
| semantic_search | Rechercher par sens (thèmes et concepts) | Lecture |
| get_object | Fiche de synthèse d'un objet | Lecture |
| get_object_attribute_schema | Attributs que peut porter le type d'un objet, avec formats et valeurs acceptées | Lecture |
| get_object_relations | Parcourir les liens, enfants, champs, ancêtres ou le mapping d'un traitement | Lecture |
| get_comments | Commentaires d'un objet | Lecture |
| get_tasks | Tâches d'un objet | Lecture |
| get_users | Identifier un utilisateur | Lecture |
| get_tags | Lister tous les tags | Lecture |
| get_technologies | Lister toutes les technologies | Lecture |
| get_data_sources | Lister les sources de données de premier niveau d'une version | Lecture |
| create_comment | Ajouter un commentaire à un objet | Écriture |
| update_object | Modifier les attributs d'un objet | Écriture |
Chaque objet est identifié par trois identifiants : workspace_id, version_id et object_id. Prenez-les toujours ensemble, depuis le même résultat de recherche ou la même liste.
Périmètre
1. list_workspaces_and_versions
Liste tous les espaces de travail avec leurs versions. Appelez cet outil en premier pour déterminer le périmètre utilisé par les autres outils. Chaque espace de travail comporte un search_version_id : la version recherchée lorsque seul workspace_id est transmis à un outil de recherche (la version officielle, sinon la version candidate). Le statut d'une version suit l'ordre active, candidate, official, archived ; un statut nul signifie que l'espace de travail n'est pas versionné.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| include_archived | boolean | Non (défaut : false) | Inclut les versions archivées. Les versions archivées sont lisibles mais ne sont recherchées que si elles sont explicitement désignées. |
Recherche
2. search_objects
Recherche des objets du catalogue par nom, par valeurs d'attributs, ou les deux. Le texte libre est comparé au nom, à la description, au résumé et aux synonymes. Utilisez filters pour toute autre condition : propriétaire, steward, tag, statut, technologie, attribut personnalisé ou relation. Les résultats sont regroupés par espace de travail et version, et chaque réponse indique le total de la plateforme : l'outil permet donc aussi de répondre aux questions « combien ».
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| query | string | Non | Texte libre comparé au nom, à la description, au résumé et aux synonymes. |
| entity_type | string | Non | Type d'objet (par ex. BusinessTerm, Table, Column, DataProcessing, Report, DataProduct). Alias acceptés : relational, nonrelational, nosql, usage. S'il est omis, la recherche porte sur les types inclus dans les paramètres de recherche du compte (par défaut tous sauf PrimaryKey et ForeignKey). Renseignez-le dès que vous filtrez ou affichez un attribut. |
| module_name | string | Non | L'une des valeurs AiProduct, Processing, DataProduct, Diagram, Catalog, Glossary, Initiative, Objective, Policy, RuleAndMonitor, Usage. Dictionary est accepté comme équivalent de Catalog. |
| filters | array | Non | Conditions sur les attributs, chacune avec attribute_key (ou le nom), operator et values. Les filtres sont combinés par ET ; les valeurs d'un même filtre par OU. Les filtres de relation utilisent des clés de la forme ObjectLinks_<LinkType>. Lorsque entity_type est renseigné, les utilisateurs peuvent être indiqués par id, e-mail ou nom complet, et les tags par leur libellé. Obtenez les clés, opérateurs et valeurs avec list_filterable_attributes. |
| included_attributes | array of strings | Non | Attributs supplémentaires à afficher sur chaque ligne, par exemple pour montrer pourquoi un objet correspond. Un nom inconnu fait échouer la recherche. |
| creation_time_operator | enum | Non | Période de création : pastHour, today, yesterday, currentWeek, pastWeek, beforeCurrentWeek, beforePastWeek, currentMonth, pastMonth, beforeCurrentMonth, beforePastMonth, beforeToday, last365days, currentYear, isEmpty, isNotEmpty. |
| modification_time_operator | enum | Non | Période de dernière modification, mêmes valeurs que ci-dessus. |
| workspace_id | string | Non | Espace de travail à rechercher. Omettez-le pour rechercher dans tous les espaces accessibles, une version chacun. |
| version_id | string | Non | Version à rechercher. Nécessite workspace_id. |
| limit | integer | Non (défaut : 20, max 50) | Résultats par page. |
| page | integer | Non (défaut : 1) | Numéro de page. La plateforme ne peut pas paginer au-delà des 10 000 premiers résultats. |
Remarques. Il n'existe ni OU entre attributs différents, ni NON : lancez plusieurs recherches et combinez-les. Les lignes de résultats contiennent l'identité, le type et l'emplacement, pas les attributs de l'objet ; utilisez get_object pour son contenu. Les espaces de travail sans version officielle ni candidate ne sont pas recherchés : un résultat absent ne prouve donc pas que l'objet n'existe pas.
3. list_filterable_attributes
Liste ce sur quoi search_objects peut filtrer pour un type d'objet dans une version d'espace de travail : le name et l'attribute_key de chaque attribut, les opérateurs acceptés et, pour les listes fermées, les valeurs exactes acceptées. Appelez-le avant de transmettre filters : les clés de filtre varient selon l'espace de travail et le type, et une clé devinée échoue ou, pour le statut, le type et le module, est ignorée et renvoie tous les objets.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| entity_type | string | Oui | Type d'objet à rechercher. |
| workspace_id | string | Oui | Espace de travail dans lequel la recherche sera lancée. |
| version_id | string | Oui | Version dans laquelle la recherche sera lancée. |
| include_relationships | boolean | Non (défaut : false) | Liste aussi les clés ObjectLinks_<LinkType> présentes dans cette version, avec le nombre d'objets concernés. Prend quelques secondes ; à utiliser uniquement pour filtrer sur une relation. Un type de lien absent de la liste n'existe pas dans cette version. |
4. semantic_search
Recherche des objets du catalogue par le sens plutôt que par les mots, pour des thèmes et concepts tels que « objets liés à la finance » ou « données RGPD ». La requête est utilisée telle quelle, sans être enrichie : pour de meilleurs résultats, lancez plusieurs recherches formulées différemment (synonymes, acronyme développé, terme métier ou technique). L'outil n'accepte aucun filtre ; utilisez search_objects lorsque la demande correspond à un filtre.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| query | string | Oui | Une phrase autonome. Intégrez le contexte des messages précédents : l'outil ne voit pas la conversation. |
| workspace_id | string | Non | Espace de travail à rechercher. Omettez-le pour rechercher dans tous les espaces accessibles, une version chacun. |
| version_id | string | Non | Version à rechercher. Nécessite workspace_id. |
| limit | integer | Non (défaut : 20, max 50) | Résultats par page. |
| page | integer | Non (défaut : 1) | Numéro de page. La profondeur totale est plafonnée. |
Objets et relations
5. get_object
Renvoie la fiche de synthèse d'un objet : ses attributs (standards et personnalisés), son emplacement (functionalPath), ses liens comptés par type de relation et type de cible, et le nombre ainsi qu'un échantillon de ses enfants et de ses champs. Les attributs vides ne sont pas affichés ; utilisez include_writability avant de conclure qu'un attribut est absent.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| object_id | string (UUID) | Oui | UUID de l'objet du catalogue. |
| workspace_id | string | Oui | Espace de travail de l'objet. |
| version_id | string | Oui | Version de l'objet. |
| include_writability | boolean | Non (défaut : false) | Indique aussi quels attributs sont modifiables et lesquels sont vides. À utiliser pour savoir si un attribut est renseigné, et avant une mise à jour. |
6. get_object_attribute_schema
Anciennement get_object_attributes. Liste tous les attributs que peut porter le type de l'objet : le schéma, pas les valeurs. Chaque entrée indique le name exact à utiliser lors d'une écriture, son format, s'il est writable et mandatory et, pour les formats à valeurs finies, les values acceptées. Utilisez-le pour distinguer un attribut vide d'un attribut que l'objet ne peut pas porter, et pour vérifier les valeurs acceptées avant update_object. Le schéma est propre au type et à l'espace de travail de l'objet.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| object_id | string (UUID) | Oui | UUID de l'objet du catalogue. |
| workspace_id | string | Oui | Espace de travail de l'objet. |
| version_id | string | Oui | Version de l'objet. |
7. get_object_relations
Parcourt une relation d'un objet, page par page, et renvoie des références à approfondir avec get_object. Les lignes de liens et de mapping incluent le functionalPath de chaque objet, pour distinguer les objets portant le même nom.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| object_id | string (UUID) | Oui | UUID de l'objet du catalogue. |
| relation | enum | Oui | links : relations sémantiques (implémentation, usage, lignage, synonymes…), comme dans l'onglet « Objets liés ».children : enfants directs dans la hiérarchie (pas les colonnes).fields : colonnes d'une table ou d'une vue, champs d'un fichier ou d'un document.ancestors : la chaîne des parents, du plus proche au plus éloigné.mapping : les éléments d'un traitement, chacun avec son opération, les entrées qu'il lit et les sorties qu'il écrit (DataProcessing uniquement). |
| workspace_id | string | Oui | Espace de travail de l'objet. |
| version_id | string | Oui | Version de l'objet. |
| link_type | string | Non | Avec relation=links : ne conserve qu'un type de relation, par ex. HasOutput. |
| target_type | string | Non | Avec relation=links : ne conserve qu'un type d'objet cible, par ex. Column. |
| limit | integer | Non (défaut : 20, max 50 ; max 40 pour links) | Éléments par page. |
| page | integer | Non (défaut : 1) | Numéro de page. |
Remarques. Pour les liens, le summary de la réponse compte tous les liens par type de relation et type de cible ; link_type et target_type filtrent les lignes et le total, jamais le summary. Un élément de mapping enregistre des ensembles d'entrées et de sorties, pas des correspondances colonne à colonne, et la réponse indique combien d'entrées et de sorties du traitement ne sont couvertes par aucun élément. Pour savoir quelle colonne de A alimente B : listez les liens de A avec link_type=IsInputOf, lisez le mapping de chaque traitement, puis conservez les éléments dont les sorties se trouvent dans B.
Commentaires et tâches
8. get_comments
Liste les commentaires d'un objet (auteur, date, texte du message).
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| object_id | string (UUID) | Oui | UUID de l'objet du catalogue. |
| workspace_id | string | Oui | Espace de travail de l'objet. |
| version_id | string | Oui | Version de l'objet. |
9. get_tasks
Liste les tâches rattachées à un objet (titre, description, statut, type, responsable et créateur, échéance).
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| object_id | string (UUID) | Oui | UUID de l'objet du catalogue. |
| workspace_id | string | Oui | Espace de travail de l'objet. |
| version_id | string | Oui | Version de l'objet. |
Données de référence
10. get_users
Liste les utilisateurs du catalogue (personnes pouvant être propriétaires ou stewards d'objets). Utilisez-le pour identifier une personne ; privilégiez l'e-mail pour distinguer des personnes aux noms proches.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| first_name | string | Non | Filtre sur le prénom (correspondance exacte). |
| last_name | string | Non | Filtre sur le nom (correspondance exacte). |
| limit | integer | Non (défaut : 20, max 50) | Résultats par page. |
| page | integer | Non (défaut : 1) | Numéro de page. |
11. get_tags
Liste tous les tags définis dans le catalogue. Les tags constituent le vocabulaire partagé entre espaces de travail pour classer les objets ; ils sont stockés en interne dans l'attribut « Domains ». Utilisez cet outil pour retrouver l'id d'un tag à partir de son nom ; ignorez les entrées dont is_active vaut false. Aucun paramètre.
12. get_technologies
Liste les technologies définies dans le catalogue, tous espaces de travail et versions confondus. Une technologie est la plateforme sur laquelle se trouvent les données d'un objet (PostgreSQL, Snowflake…). Utilisez cet outil pour retrouver le technology_code d'une technologie à partir de son nom. Aucun paramètre.
13. get_data_sources
Liste les sources de données de premier niveau (bases de données, stockages de fichiers, bases NoSQL) d'une version, par exemple pour répondre à « quelles bases de données avons-nous ? ». Explorez une source avec get_object ou get_object_relations.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| version_id | string | Oui | Version concernée. |
| limit | integer | Non (défaut : 20, max 50) | Résultats par page. |
| page | integer | Non (défaut : 1) | Numéro de page. |
Outils d'écriture
Ces deux outils modifient le catalogue. Les modifications sont visibles par toutes les personnes ayant accès à l'objet, exactement comme si elles avaient été faites dans DataGalaxy, et dépendent des droits du compte connecté. Nous recommandons que votre assistant demande une confirmation avant chaque écriture ; voir Instructions système du serveur MCP DataGalaxy.
14. create_comment
Crée un commentaire sur un objet. Le tag d'utilisateurs ou d'équipes n'est pas pris en charge.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| object_id | string (UUID) | Oui | UUID de l'objet à commenter. |
| workspace_id | string | Oui | Espace de travail de l'objet. |
| version_id | string | Oui | Version de l'objet. |
| message | string | Oui | Texte du commentaire. Le HTML / texte enrichi est accepté, par ex. <p>…</p>. |
15. update_object
Modifie un ou plusieurs attributs d'un objet. Appelez d'abord get_object sur l'objet cible, pour vérifier qu'il s'agit du bon objet et voir les valeurs qui vont être remplacées. En cas de doute sur les valeurs acceptées, appelez get_object_attribute_schema : un attribut que l'objet ne peut pas porter, ou une valeur hors de sa liste, est refusé. L'outil renvoie une confirmation, pas l'objet ; appelez get_object pour voir le nouvel état.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| object_id | string (UUID) | Oui | UUID de l'objet à mettre à jour. |
| workspace_id | string | Oui | Espace de travail de l'objet. |
| version_id | string | Oui | Version de l'objet. |
| attributes | object | Oui | Dictionnaire plat {nom: valeur} utilisant les noms renvoyés par get_object, par ex. {"status": "Validated"}. Seules les clés transmises sont modifiées. Les listes (owners, stewards, tags) remplacent la valeur actuelle : pour ajouter un élément, envoyez la liste complète, éléments existants compris. |
Nouveautés de cette version
- Nouvel outil : list_filterable_attributes.
- get_object_attributes est renommé get_object_attribute_schema.
- search_objects permet désormais de filtrer sur n'importe quel attribut ou relation (
filters) et d'afficher des attributs supplémentaires sur les lignes (included_attributes). - get_object_relations ajoute la relation
mappingainsi que les filtreslink_typeettarget_type.