Strumento: list-repo-links
Elenca i link ai repository Git in una connessione.
Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP list-repo-links.
| Richiesta 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 }' |
Schema di input
Messaggio per richiedere un elenco di GitRepositoryLink
ListGitRepositoryLinksRequest
| Rappresentazione JSON |
|---|
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string } |
| Campi | |
|---|---|
parent |
Obbligatorio. Valore della risorsa padre per ListGitRepositoryLinksRequest. |
pageSize |
Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato. |
pageToken |
Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire. |
filter |
Facoltativo. Filtro dei risultati. |
orderBy |
Facoltativo. Suggerimento su come ordinare i risultati. |
Schema di output
Messaggio per la risposta alle risorse GitRepositoryLink
ListGitRepositoryLinksResponse
| Rappresentazione JSON |
|---|
{
"gitRepositoryLinks": [
{
object ( |
| Campi | |
|---|---|
gitRepositoryLinks[] |
L'elenco di GitRepositoryLink. |
nextPageToken |
Un token che identifica una pagina di risultati che il server deve restituire. |
unreachable[] |
Località non raggiungibili. |
GitRepositoryLink
| Rappresentazione 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 } |
| Campi | |
|---|---|
name |
Identificatore. Nome risorsa del repository, nel formato |
cloneUri |
Obbligatorio. URI clone Git. |
createTime |
Solo output. Timestamp creazione. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
updateTime |
Solo output. Timestamp aggiornamento. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
deleteTime |
Solo output. Elimina il timestamp. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
labels |
Facoltativo. Etichette come coppie chiave-valore Un oggetto contenente un elenco di coppie |
etag |
Facoltativo. Questo checksum viene calcolato dal server in base al valore di altri campi e può essere inviato con le richieste di aggiornamento ed eliminazione per garantire che il client abbia un valore aggiornato prima di procedere. |
reconciling |
Solo output. Impostato su true quando la connessione viene configurata o aggiornata in background. |
annotations |
Facoltativo. Consente ai client di archiviare piccole quantità di dati arbitrari. Un oggetto contenente un elenco di coppie |
uid |
Solo output. Un identificatore univoco assegnato dal sistema per GitRepositoryLink. |
webhookId |
Solo output. ID esterno del webhook creato per il repository. |
gitProxyUri |
Solo output. URI per accedere al repository collegato tramite il proxy Git. Questo campo viene compilato solo se il proxy Git è abilitato per la connessione. |
Timestamp
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
Rappresenta i secondi dell'ora UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (che corrisponde a un intervallo compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z). |
nanos |
Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori dei secondi negativi con frazioni devono comunque avere valori di nanosecondi non negativi che avanzano nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi. |
LabelsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
AnnotationsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
Annotazioni dello strumento
Le annotazioni degli strumenti vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare un prompt di conferma a un utente.
Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:
readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.
Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌