MCP Tools Reference: developerconnect.googleapis.com

Herramienta: list-repo-links

Enumera los vínculos a repositorios de Git en una conexión.

En la siguiente muestra de código, se indica cómo usar curl para llamar a la herramienta de MCP list-repo-links.

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": "list-repo-links", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }'

Esquema de entrada

Mensaje para solicitar una lista de GitRepositoryLinks

ListGitRepositoryLinksRequest

Representación JSON
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string }

Campos
parent	string Obligatorio. Es el valor superior de ListGitRepositoryLinksRequest.
pageSize	integer Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.
pageToken	string Opcional. Un token que identifica una página de resultados que el servidor debe devolver.
filter	string Opcional. Filtra resultados.
orderBy	string Opcional. Es una sugerencia sobre cómo ordenar los resultados.

Esquema de salida

Mensaje para la respuesta a la lista de GitRepositoryLinks

ListGitRepositoryLinksResponse

Representación JSON
{ "gitRepositoryLinks": [ { object (GitRepositoryLink) } ], "nextPageToken": string, "unreachable": [ string ] }

Campos
gitRepositoryLinks[]	object (GitRepositoryLink) Es la lista de GitRepositoryLinks.
nextPageToken	string Un token que identifica una página de resultados que el servidor debe devolver.
unreachable[]	string Ubicaciones a las que no se pudo llegar.

GitRepositoryLink

Representación JSON
{ "name": string, "cloneUri": string, "createTime": string, "updateTime": string, "deleteTime": string, "labels": { string: string, ... }, "etag": string, "reconciling": boolean, "annotations": { string: string, ... }, "uid": string, "webhookId": string, "gitProxyUri": string }

Campos
name	string Es el identificador. Es el nombre del recurso del repositorio, en el formato projects/*/locations/*/connections/*/gitRepositoryLinks/*.
cloneUri	string Obligatorio. Es el URI de clonación de Git.
createTime	string (Timestamp format) Solo salida. Marca de tiempo de la fecha de creación. 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. Es la marca de tiempo de la actualización. 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".
deleteTime	string (Timestamp format) Solo salida. Borrar marca de tiempo. 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".
labels	map (key: string, value: string) Opcional. Etiquetas como pares clave-valor Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
etag	string Es opcional. El servidor calcula esta suma de comprobación según el valor de otros campos y se puede enviar en las solicitudes de actualización y eliminación para garantizar que el cliente tenga un valor actualizado antes de continuar.
reconciling	boolean Solo salida. Se establece en verdadero cuando la conexión se configura o actualiza en segundo plano.
annotations	map (key: string, value: string) Es opcional. Permite que los clientes almacenen pequeñas cantidades de datos arbitrarios. Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid	string Solo salida. Es un identificador único asignado por el sistema para el GitRepositoryLink.
webhookId	string Solo salida. Es el ID externo del webhook creado para el repositorio.
gitProxyUri	string Solo salida. Es el URI para acceder al repositorio vinculado a través del proxy de Git. Este campo solo se completa si el proxy de Git está habilitado para la conexión.

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.

LabelsEntry

Representación JSON
{ "key": string, "value": string }

Campos
key	string
value	string

AnnotationsEntry

Representación JSON
{ "key": string, "value": string }

Campos
key	string
value	string

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 de destructivo: ❌ | Sugerencia de idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌