MCP Tools Reference: developerconnect.googleapis.com

Outil : diff-repo-commit

Obtenez la différence entre deux commits dans un dépôt Git. Pour récupérer des fragments de correctif ligne par ligne, transmettez path_filters (par exemple, ['**'] pour tous les fichiers).

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP diff-repo-commit.

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": "diff-repo-commit",
    "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 DiffGitRepositoryLinkCommit.

DiffGitRepositoryLinkCommitRequest

Représentation JSON 
{
  "name": string,
  "baseSha": string,
  "headSha": string,
  "pathFilters": [
    string
  ]
}
Champs
name

string

Obligatoire. Nom de ressource du GitRepositoryLink.
baseSha

string

Obligatoire. SHA ou référence du commit de base.
headSha

string

Obligatoire. SHA ou référence du commit de tête.
pathFilters[]

string

Facultatif. Modèles de chemin d'accès ou chemins d'accès exacts pour filtrer les fichiers renvoyés. Lorsque path_filters est spécifié, FileDiff.patch est renseigné pour tous les fichiers correspondants (utilisez ["**"] pour inclure des correctifs pour tous les fichiers modifiés). Lorsque path_filters est omis ou vide, la liste complète des FileDiff est renvoyée sans différences de correctif (FileDiff.patch est vide).

Schéma de sortie

Message de réponse pour DiffGitRepositoryLinkCommit.

DiffGitRepositoryLinkCommitResponse

Représentation JSON 
{
  "files": [
    {
      object (FileDiff)
    }
  ]
}
Champs
files[]

object (FileDiff)

Différence de fichier extraite de la différence unifiée.

FileDiff

Représentation JSON 
{
  "path": string,
  "status": string,
  "patch": string
}
Champs
path

string

Chemin relatif au fichier dans le dépôt.
status

string

État de la modification : "ADDED", "MODIFIED", "REMOVED", "RENAMED".
patch

string

Fragment de correctif diff unifié standard pour le fichier. Renseigné uniquement lorsque path_filters est spécifié dans la requête. Sinon, vide.

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