MCP Tools Reference: developerconnect.googleapis.com

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

Fügen Sie einem Pull-Anfrage einen Überprüfungskommentar (inline im Diff) hinzu.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool add-repo-pull-request-review-comment 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": "add-repo-pull-request-review-comment",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für AddGitRepositoryLinkPullRequestReviewComment.

AddGitRepositoryLinkPullRequestReviewCommentRequest

JSON-Darstellung 
{
  "name": string,
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Felder
name

string

Pflichtangabe. Der Ressourcenname des GitRepositoryLink im Format projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequestId

string

Pflichtangabe. Die ID des Pull-Requests.
comment

object (PullRequestReviewComment)

Pflichtangabe. Der hinzuzufügende Überprüfungskommentar.
commitId

string

Optional. Der Commit-SHA, der kommentiert werden soll. Wenn nicht angegeben, wird standardmäßig der HEAD-Commit der Pull-Anfrage verwendet.

PullRequestReviewComment

JSON-Darstellung 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Felder
id

string

Nur Ausgabe. Die ID des Kommentars.
body

string

Pflichtangabe. Der Text des Kommentars.
path

string

Pflichtangabe. Der Dateipfad, zu dem ein Kommentar hinzugefügt werden soll.
firstLine

integer

Optional. Die erste Zeile des Kommentarbereichs (einschließlich). Wenn nichts angegeben ist, gilt der Kommentar nur für die last_line.
lastLine

integer

Pflichtangabe. Die letzte Zeile des Kommentarbereichs (einschließlich). Wenn first_line nicht angegeben ist, gilt der Kommentar nur für diese Zeile.
side

enum (DiffSide)

Optional. Die Seite des Diff, die kommentiert werden soll. Die Standardeinstellung ist HEAD.
author

string

Nur Ausgabe. Der Nutzername des Autors.
createTime

string (Timestamp format)

Nur Ausgabe. Wann der Kommentar erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Wann der Kommentar aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
commitId

string

Nur Ausgabe. Der Commit-SHA, auf den der Kommentar tatsächlich angewendet wurde.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss zwischen -62135596800 und 253402300799 (einschließlich) liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld ist der Nanosekunden-Teil der Dauer, keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 (einschließlich) liegen.

DiffSide

„DiffSide“ gibt an, auf welcher Seite des Vergleichs sich der Kommentar befindet.

Enums
DIFF_SIDE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
BASE Die Seite des Diff vor den Änderungen (gelöschte oder geänderte Zeilen).
HEAD Die Seite des Diff nach den Änderungen (hinzugefügte oder geänderte Zeilen).

Ausgabeschema

Nachricht, die einen SCM-Pull-Anfrage-Überprüfungskommentar darstellt (inline im Diff).

PullRequestReviewComment

JSON-Darstellung 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Felder
id

string

Nur Ausgabe. Die ID des Kommentars.
body

string

Pflichtangabe. Der Text des Kommentars.
path

string

Pflichtangabe. Der Dateipfad, zu dem ein Kommentar hinzugefügt werden soll.
firstLine

integer

Optional. Die erste Zeile des Kommentarbereichs (einschließlich). Wenn nichts angegeben ist, gilt der Kommentar nur für die last_line.
lastLine

integer

Pflichtangabe. Die letzte Zeile des Kommentarbereichs (einschließlich). Wenn first_line nicht angegeben ist, gilt der Kommentar nur für diese Zeile.
side

enum (DiffSide)

Optional. Die Seite des Diff, die kommentiert werden soll. Die Standardeinstellung ist HEAD.
author

string

Nur Ausgabe. Der Nutzername des Autors.
createTime

string (Timestamp format)

Nur Ausgabe. Wann der Kommentar erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Wann der Kommentar aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
commitId

string

Nur Ausgabe. Der Commit-SHA, auf den der Kommentar tatsächlich angewendet wurde.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss zwischen -62135596800 und 253402300799 (einschließlich) liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld ist der Nanosekunden-Teil der Dauer, keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 (einschließlich) liegen.

DiffSide

„DiffSide“ gibt an, auf welcher Seite des Vergleichs sich der Kommentar befindet.

Enums
DIFF_SIDE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
BASE Die Seite des Diff vor den Änderungen (gelöschte oder geänderte Zeilen).
HEAD Die Seite des Diff nach den Änderungen (hinzugefügte oder geänderte Zeilen).

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