Outil : list-repo-links
Répertorier les liens de dépôt Git sous une connexion.
L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP list-repo-links.
| Requête curl |
|---|
curl --location 'https://developerconnect.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list-repo-links", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Schéma d'entrée
Message de demande d'une liste de GitRepositoryLinks
ListGitRepositoryLinksRequest
| Représentation JSON |
|---|
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string } |
| Champs | |
|---|---|
parent |
Obligatoire. Valeur parente pour ListGitRepositoryLinksRequest. |
pageSize |
Facultatif. Taille de la page demandée. Le serveur peut renvoyer un nombre d'éléments inférieur à celui demandé. Si aucune valeur n'est spécifiée, le serveur sélectionne une valeur par défaut appropriée. |
pageToken |
Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer. |
filter |
Facultatif. Filtrage des résultats. |
orderBy |
Facultatif. Indication sur la façon d'organiser les résultats. |
Schéma de sortie
Message de réponse pour la liste des GitRepositoryLinks
ListGitRepositoryLinksResponse
| Représentation JSON |
|---|
{
"gitRepositoryLinks": [
{
object ( |
| Champs | |
|---|---|
gitRepositoryLinks[] |
Liste des GitRepositoryLinks. |
nextPageToken |
Jeton identifiant une page de résultats que le serveur doit renvoyer. |
unreachable[] |
Emplacements inaccessibles. |
GitRepositoryLink
| Représentation JSON |
|---|
{ "name": string, "cloneUri": string, "createTime": string, "updateTime": string, "deleteTime": string, "labels": { string: string, ... }, "etag": string, "reconciling": boolean, "annotations": { string: string, ... }, "uid": string, "webhookId": string, "gitProxyUri": string } |
| Champs | |
|---|---|
name |
Identifiant. Nom de ressource du dépôt, au format |
cloneUri |
Obligatoire. URI de clonage Git. |
createTime |
Uniquement en sortie. Code temporel de création. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
updateTime |
Uniquement en sortie. Horodatage de mise à jour. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
deleteTime |
Uniquement en sortie. Supprimez le code temporel. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
labels |
Facultatif. Étiquettes sous forme de paires clé/valeur Objet contenant une liste de paires |
etag |
Facultatif. Cette somme de contrôle est calculée par le serveur en fonction de la valeur des autres champs. Elle peut être envoyée lors des requêtes de mise à jour et de suppression pour s'assurer que le client dispose d'une valeur à jour avant de continuer. |
reconciling |
Uniquement en sortie. Défini sur "true" lorsque la connexion est en cours de configuration ou de mise à jour en arrière-plan. |
annotations |
Facultatif. Permet aux clients de stocker de petites quantités de données arbitraires. Objet contenant une liste de paires |
uid |
Uniquement en sortie. Identifiant unique attribué par le système pour GitRepositoryLink. |
webhookId |
Uniquement en sortie. ID externe du webhook créé pour le dépôt. |
gitProxyUri |
Uniquement en sortie. URI permettant d'accéder au dépôt associé via le proxy Git. Ce champ n'est renseigné que si le proxy Git est activé pour la connexion. |
Horodatage
| Représentation JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Champs | |
|---|---|
seconds |
Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. Doit être compris entre -62135596800 et 253402300799 inclus (ce qui correspond à la période allant du 01/01/0001 à 00:00:00 UTC au 31/12/9999 à 23:59:59 UTC). |
nanos |
Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 (inclus). |
LabelsEntry
| Représentation JSON |
|---|
{ "key": string, "value": string } |
| Champs | |
|---|---|
key |
|
value |
|
AnnotationsEntry
| Représentation JSON |
|---|
{ "key": string, "value": string } |
| Champs | |
|---|---|
key |
|
value |
|
Annotations d'outils
Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients considèrent ces indications comme non fiables, mais elles peuvent être utilisées pour décider quand envoyer une invite de confirmation à un utilisateur.
En plus de la chaîne de titre, les indices booléens suivants sont définis comme suit :
readOnlyHint: si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".destructiveHint: si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".idempotentHint: si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".openWorldHint: si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.
Indice "Destructive" : ❌ | Indice "Idempotent" : ✅ | Indice "Read Only" : ✅ | Indice "Open World" : ❌