MCP Tools Reference: developerconnect.googleapis.com

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

Agrega un comentario de revisión (intercalado en la diferencia) a una solicitud de extracción.

En la siguiente muestra de código, se indica cómo usar curl para llamar a la herramienta de MCP add-repo-pull-request-review-comment.

Solicitud de 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
}'

Esquema de entrada

Mensaje de solicitud para AddGitRepositoryLinkPullRequestReviewComment.

AddGitRepositoryLinkPullRequestReviewCommentRequest

Representación JSON 
{
  "name": string,
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Campos
name

string

Obligatorio. Es el nombre del recurso de GitRepositoryLink en el formato projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequestId

string

Obligatorio. Es el ID de la solicitud de extracción.
comment

object (PullRequestReviewComment)

Obligatorio. Es el comentario de la opinión que se agregará.
commitId

string

Es opcional. Es el SHA de la confirmación sobre la que se comentará. Si no se especifica, se usa de forma predeterminada la confirmación HEAD de la solicitud de extracción.

PullRequestReviewComment

Representación JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Campos
id

string

Solo salida. Es el ID del comentario.
body

string

Obligatorio. Es el cuerpo del comentario.
path

string

Obligatorio. Es la ruta de acceso del archivo sobre el que se agregará el comentario.
firstLine

integer

Es opcional. Es la primera línea del rango de comentarios (inclusive). Si no se especifica, el comentario se aplica solo a last_line.
lastLine

integer

Obligatorio. Es la última línea del rango de comentarios (inclusive). Si no se especifica first_line, el comentario se aplica solo a esta línea.
side

enum (DiffSide)

Es opcional. El lado de la diferencia que se comentará. La configuración predeterminada es HEAD.
author

string

Solo salida. Es el nombre de usuario del autor.
createTime

string (Timestamp format)

Solo salida. Cuándo se creó el comentario.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Cuándo se actualizó el comentario.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
commitId

string

Solo salida. Es el SHA de confirmación al que se aplicó el comentario.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos del horario UTC desde el tiempo Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de nanosegundos de la duración, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Deben ser valores de 0 a 999,999,999 inclusive.

DiffSide

DiffSide representa en qué lado de la diferencia se encuentra el comentario.

Enums
DIFF_SIDE_UNSPECIFIED Valor predeterminado. Este valor no se usa.
BASE El lado de la diferencia antes de los cambios (líneas borradas o modificadas).
HEAD El lado de la diferencia después de los cambios (líneas agregadas o modificadas).

Esquema de salida

Es un mensaje que representa un comentario de revisión de solicitud de extracción de SCM (intercalado en diff).

PullRequestReviewComment

Representación JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Campos
id

string

Solo salida. Es el ID del comentario.
body

string

Obligatorio. Es el cuerpo del comentario.
path

string

Obligatorio. Es la ruta de acceso del archivo sobre el que se agregará el comentario.
firstLine

integer

Es opcional. Es la primera línea del rango de comentarios (inclusive). Si no se especifica, el comentario se aplica solo a last_line.
lastLine

integer

Obligatorio. Es la última línea del rango de comentarios (inclusive). Si no se especifica first_line, el comentario se aplica solo a esta línea.
side

enum (DiffSide)

Es opcional. El lado de la diferencia que se comentará. La configuración predeterminada es HEAD.
author

string

Solo salida. Es el nombre de usuario del autor.
createTime

string (Timestamp format)

Solo salida. Cuándo se creó el comentario.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Cuándo se actualizó el comentario.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
commitId

string

Solo salida. Es el SHA de confirmación al que se aplicó el comentario.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos del horario UTC desde el tiempo Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de nanosegundos de la duración, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Deben ser valores de 0 a 999,999,999 inclusive.

DiffSide

DiffSide representa en qué lado de la diferencia se encuentra el comentario.

Enums
DIFF_SIDE_UNSPECIFIED Valor predeterminado. Este valor no se usa.
BASE El lado de la diferencia antes de los cambios (líneas borradas o modificadas).
HEAD El lado de la diferencia después de los cambios (líneas agregadas o modificadas).

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, las siguientes sugerencias booleanas se definen de la siguiente manera:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia destructiva: ❌ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ❌ | Sugerencia de mundo abierto: ❌