MCP Tools Reference: developerconnect.googleapis.com

Outil : add-repo-pull-request-review-comment

Ajouter un commentaire d'examen (intégré au diff) à une demande d'extraction;extraction.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP add-repo-pull-request-review-comment.

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": "add-repo-pull-request-review-comment",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Message de requête pour AddGitRepositoryLinkPullRequestReviewComment.

AddGitRepositoryLinkPullRequestReviewCommentRequest

Représentation JSON 
{
  "name": string,
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Champs
name

string

Obligatoire. Nom de ressource du GitRepositoryLink au format projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequestId

string

Obligatoire. ID de la demande d'extraction.
comment

object (PullRequestReviewComment)

Obligatoire. Commentaire d'examen à ajouter.
commitId

string

Facultatif. SHA du commit à commenter. Si aucune valeur n'est spécifiée, la valeur par défaut est le commit HEAD de la demande d'extraction.

PullRequestReviewComment

Représentation JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Champs
id

string

Uniquement en sortie. ID du commentaire.
body

string

Obligatoire. Corps du commentaire.
path

string

Obligatoire. Chemin d'accès au fichier à commenter.
firstLine

integer

Facultatif. Première ligne de la plage de commentaires (incluse). Si aucune valeur n'est spécifiée, le commentaire ne s'applique qu'à last_line.
lastLine

integer

Obligatoire. Dernière ligne de la plage de commentaires (incluse). Si first_line n'est pas spécifié, le commentaire ne s'applique qu'à cette ligne.
side

enum (DiffSide)

Facultatif. Côté de la différence à commenter. La valeur par défaut est HEAD.
author

string

Uniquement en sortie. Nom d'utilisateur de l'auteur.
createTime

string (Timestamp format)

Uniquement en sortie. Date de création du commentaire.

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 : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Date de mise à jour du commentaire.

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 : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
commitId

string

Uniquement en sortie. SHA du commit auquel le commentaire a été appliqué.

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

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

integer

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).

DiffSide

"DiffSide" représente le côté de la différence sur lequel se trouve le commentaire.

Enums
DIFF_SIDE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
BASE Côté de la comparaison avant les modifications (lignes supprimées ou modifiées).
HEAD Côté de la comparaison après les modifications (lignes ajoutées ou modifiées).

Schéma de sortie

Message représentant un commentaire de révision de demande d'extraction SCM (intégré à la différence).

PullRequestReviewComment

Représentation JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Champs
id

string

Uniquement en sortie. ID du commentaire.
body

string

Obligatoire. Corps du commentaire.
path

string

Obligatoire. Chemin d'accès au fichier à commenter.
firstLine

integer

Facultatif. Première ligne de la plage de commentaires (incluse). Si aucune valeur n'est spécifiée, le commentaire ne s'applique qu'à last_line.
lastLine

integer

Obligatoire. Dernière ligne de la plage de commentaires (incluse). Si first_line n'est pas spécifié, le commentaire ne s'applique qu'à cette ligne.
side

enum (DiffSide)

Facultatif. Côté de la différence à commenter. La valeur par défaut est HEAD.
author

string

Uniquement en sortie. Nom d'utilisateur de l'auteur.
createTime

string (Timestamp format)

Uniquement en sortie. Date de création du commentaire.

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 : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Date de mise à jour du commentaire.

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 : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
commitId

string

Uniquement en sortie. SHA du commit auquel le commentaire a été appliqué.

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

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

integer

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).

DiffSide

"DiffSide" représente le côté de la différence sur lequel se trouve le commentaire.

Enums
DIFF_SIDE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
BASE Côté de la comparaison avant les modifications (lignes supprimées ou modifiées).
HEAD Côté de la comparaison après les modifications (lignes ajoutées ou modifiées).

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.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌