MCP Tools Reference: developerconnect.googleapis.com

Outil : fetch-repo-pull-request

Récupérez les détails d'une demande d'extraction spécifique à partir d'un dépôt Git.

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

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": "fetch-repo-pull-request",
    "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 FetchGitRepositoryLinkPullRequest.

FetchGitRepositoryLinkPullRequestRequest

Représentation JSON 
{
  "name": string,
  "pullRequestId": 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.

Schéma de sortie

Message représentant une demande d'extraction SCM.

PullRequest

Représentation JSON 
{
  "id": string,
  "title": string,
  "body": string,
  "headRef": string,
  "baseRef": string,
  "author": string,
  "createTime": string,
  "updateTime": string,
  "mergeTime": string,
  "closeTime": string,
  "declineTime": string,
  "state": enum (State),
  "mergeability": enum (Mergeability),
  "htmlUrl": string
}
Champs
id

string

Obligatoire. ID de la demande d'extraction.
title

string

Obligatoire. Titre de la demande d'extraction.
body

string

Facultatif. Description du corps de la demande d'extraction.
headRef

string

Obligatoire. SHA du commit source de la branche de tête.
baseRef

string

Obligatoire. SHA du commit cible de la branche de base.
author

string

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

string (Timestamp format)

Uniquement en sortie. Date de création de la RP.

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 de la demande d'extraction.

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".
mergeTime

string (Timestamp format)

Uniquement en sortie. Date de fusion de la demande d'extraction.

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".
closeTime

string (Timestamp format)

Uniquement en sortie. Date et heure de fermeture de la demande d'extraction.

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".
declineTime

string (Timestamp format)

Uniquement en sortie. Date et heure de refus de la demande d'extraction. Défini uniquement pour les fournisseurs de gestion de code source qui permettent de refuser les demandes d'extraction. Jamais défini pour GitHub, GitHub Enterprise, GitLab ou GitLab Enterprise, où une demande d'extraction fermée sans être fusionnée est CLOSED.

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".
state

enum (State)

Uniquement en sortie. État actuel de la demande d'extraction.
mergeability

enum (Mergeability)

Uniquement en sortie. État de fusion de la demande d'extraction.
htmlUrl

string

Uniquement en sortie. URL HTML de la demande d'extraction sur le fournisseur de gestion de code source.

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

État

État de la demande d'extraction.

Enums
STATE_UNSPECIFIED Valeur par défaut.
OPEN La demande d'extraction est ouverte.
CLOSED La demande d'extraction est fermée.
MERGED La demande d'extraction est fusionnée.
DECLINED La demande d'extraction est refusée. Utilisé uniquement par les fournisseurs de gestion de code source qui permettent de refuser les demandes d'extraction. Jamais utilisé pour GitHub, GitHub Enterprise, GitLab ou GitLab Enterprise, où une demande d'extraction fermée sans être fusionnée est CLOSED.

Possibilité de fusion

État de fusion d'une demande d'extraction;extraction.

Enums
MERGEABILITY_UNSPECIFIED L'état de fusion n'est pas spécifié.
MERGEABLE La demande d'extraction peut être fusionnée sans problème, sans conflit Git.
CONFLICTING La demande d'extraction présente des conflits de fusion et ne peut pas être fusionnée correctement.
COMPUTING L'état de fusion est actuellement calculé de manière asynchrone par le fournisseur de gestion de code source en amont.

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" : ❌