MCP Tools Reference: developerconnect.googleapis.com

Tool: diff-repo-commit

Diff zwischen zwei Commits in einem Git-Repository abrufen. Wenn Sie zeilenweise Patch-Hunks abrufen möchten, übergeben Sie „path_filters“ (z. B. ['**'] für alle Dateien).

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool diff-repo-commit aufrufen.

Curl-Anfrage 
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
}'

Eingabeschema

Anfragenachricht für DiffGitRepositoryLinkCommit.

DiffGitRepositoryLinkCommitRequest

JSON-Darstellung 
{
  "name": string,
  "baseSha": string,
  "headSha": string,
  "pathFilters": [
    string
  ]
}
Felder
name

string

Pflichtangabe. Der Ressourcenname des GitRepositoryLink.
baseSha

string

Pflichtangabe. Der Basis-Commit-SHA oder die Referenz.
headSha

string

Pflichtangabe. Der Head-Commit-SHA oder die Referenz.
pathFilters[]

string

Optional. Pfadmuster oder genaue Pfade zum Filtern zurückgegebener Dateien. Wenn path_filters angegeben ist, wird FileDiff.patch für alle übereinstimmenden Dateien ausgefüllt. Verwenden Sie ["**"], um Patches für alle geänderten Dateien einzuschließen. Wenn path_filters weggelassen wird oder leer ist, wird die vollständige Liste der FileDiff ohne Patch-Diffs zurückgegeben (FileDiff.patch ist leer).

Ausgabeschema

Antwortnachricht für DiffGitRepositoryLinkCommit.

DiffGitRepositoryLinkCommitResponse

JSON-Darstellung 
{
  "files": [
    {
      object (FileDiff)
    }
  ]
}
Felder
files[]

object (FileDiff)

Der aus dem Unified Diff extrahierte Datei-Diff.

FileDiff

JSON-Darstellung 
{
  "path": string,
  "status": string,
  "patch": string
}
Felder
path

string

Relativer Pfad zur Datei im Repository.
status

string

Status der Änderung: „ADDED“, „MODIFIED“, „REMOVED“, „RENAMED“.
patch

string

Standardmäßiger einheitlicher Diff-Patch-Hunk für die Datei. Wird nur ausgefüllt, wenn path_filters in der Anfrage angegeben ist, andernfalls leer.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Zusätzlich zum Titelstring werden die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Tool für die Websuche wäre beispielsweise ein Open-World-Tool, ein Tool für gemerkte Informationen dagegen nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Lesezugriff-Hinweis: ✅ | Open-World-Hinweis: ❌