MCP Tools Reference: developerconnect.googleapis.com

Strumento: open-repo-pull-request

Apri una richiesta di pull nel repository SCM remoto.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP open-repo-pull-request.

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

Schema di input

Messaggio per l'apertura della richiesta di pull SCM.

OpenGitRepositoryLinkPullRequestRequest

Rappresentazione JSON 
{
  "name": string,
  "pullRequest": {
    object (PullRequest)
  }
}
Campi
name

string

Obbligatorio. Il nome della risorsa GitRepositoryLink nel formato projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequest

object (PullRequest)

Obbligatorio. I dettagli della richiesta di pull da aprire. Campi di immissione utilizzati: title, body, head_ref, base_ref.

PullRequest

Rappresentazione JSON 
{
  "id": string,
  "title": string,
  "body": string,
  "headRef": string,
  "baseRef": string,
  "author": string,
  "createTime": string,
  "updateTime": string,
  "mergeTime": string,
  "closeTime": string,
  "declineTime": string,
  "state": enum (State),
  "mergeability": enum (Mergeability),
  "htmlUrl": string
}
Campi
id

string

Obbligatorio. L'ID della PR.
title

string

Obbligatorio. Il titolo della PR.
body

string

Facoltativo. La descrizione del corpo della PR.
headRef

string

Obbligatorio. Lo SHA del commit di origine del branch head.
baseRef

string

Obbligatorio. Lo SHA del commit di destinazione del branch di base.
author

string

Solo output. Il nome utente dell'autore.
createTime

string (Timestamp format)

Solo output. Quando è stata creata la PR.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Quando è stata aggiornata la PR.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
mergeTime

string (Timestamp format)

Solo output. Quando è stato eseguito il merge della PR.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
closeTime

string (Timestamp format)

Solo output. Quando la PR è stata chiusa.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
declineTime

string (Timestamp format)

Solo output. Quando la richiesta di pull è stata rifiutata. Impostato solo per i provider SCM che supportano il rifiuto delle richieste di pull. Non viene mai impostato per GitHub, GitHub Enterprise, GitLab o GitLab Enterprise, dove una richiesta di pull chiusa senza essere unita è CLOSED.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
state

enum (State)

Solo output. Lo stato attuale della PR.
mergeability

enum (Mergeability)

Solo output. Lo stato di unione della richiesta di pull.
htmlUrl

string

Solo output. L'URL HTML della richiesta di pull sul provider SCM.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

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

integer

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.

Stato

Lo stato della PR.

Enum
STATE_UNSPECIFIED Valore predefinito.
OPEN La PR è aperta.
CLOSED La PR è chiusa.
MERGED La PR viene unita.
DECLINED La richiesta di pagamento viene rifiutata. Utilizzato solo dai provider SCM che supportano il rifiuto delle richieste di pull. Non viene mai utilizzato per GitHub, GitHub Enterprise, GitLab o GitLab Enterprise, dove una richiesta di pull chiusa senza essere unita è CLOSED.

Unificabilità

Lo stato di unione di una richiesta di pull.

Enum
MERGEABILITY_UNSPECIFIED Lo stato di unione non è specificato.
MERGEABLE La richiesta di pull può essere unita in modo pulito senza conflitti Git.
CONFLICTING La richiesta di pull presenta conflitti di unione e non può essere unita in modo pulito.
COMPUTING Lo stato di unione è attualmente calcolato in modo asincrono dal provider SCM upstream.

Schema di output

Messaggio che rappresenta una richiesta di pull SCM.

PullRequest

Rappresentazione JSON 
{
  "id": string,
  "title": string,
  "body": string,
  "headRef": string,
  "baseRef": string,
  "author": string,
  "createTime": string,
  "updateTime": string,
  "mergeTime": string,
  "closeTime": string,
  "declineTime": string,
  "state": enum (State),
  "mergeability": enum (Mergeability),
  "htmlUrl": string
}
Campi
id

string

Obbligatorio. L'ID della PR.
title

string

Obbligatorio. Il titolo della PR.
body

string

Facoltativo. La descrizione del corpo della PR.
headRef

string

Obbligatorio. Lo SHA del commit di origine del branch head.
baseRef

string

Obbligatorio. Lo SHA del commit di destinazione del branch di base.
author

string

Solo output. Il nome utente dell'autore.
createTime

string (Timestamp format)

Solo output. Quando è stata creata la PR.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Quando è stata aggiornata la PR.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
mergeTime

string (Timestamp format)

Solo output. Quando è stato eseguito il merge della PR.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
closeTime

string (Timestamp format)

Solo output. Quando la PR è stata chiusa.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
declineTime

string (Timestamp format)

Solo output. Quando la richiesta di pull è stata rifiutata. Impostato solo per i provider SCM che supportano il rifiuto delle richieste di pull. Non viene mai impostato per GitHub, GitHub Enterprise, GitLab o GitLab Enterprise, dove una richiesta di pull chiusa senza essere unita è CLOSED.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
state

enum (State)

Solo output. Lo stato attuale della PR.
mergeability

enum (Mergeability)

Solo output. Lo stato di unione della richiesta di pull.
htmlUrl

string

Solo output. L'URL HTML della richiesta di pull sul provider SCM.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

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

integer

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.

Stato

Lo stato della PR.

Enum
STATE_UNSPECIFIED Valore predefinito.
OPEN La PR è aperta.
CLOSED La PR è chiusa.
MERGED La PR viene unita.
DECLINED La richiesta di pagamento viene rifiutata. Utilizzato solo dai provider SCM che supportano il rifiuto delle richieste di pull. Non viene mai utilizzato per GitHub, GitHub Enterprise, GitLab o GitLab Enterprise, dove una richiesta di pull chiusa senza essere unita è CLOSED.

Unificabilità

Lo stato di unione di una richiesta di pull.

Enum
MERGEABILITY_UNSPECIFIED Lo stato di unione non è specificato.
MERGEABLE La richiesta di pull può essere unita in modo pulito senza conflitti Git.
CONFLICTING La richiesta di pull presenta conflitti di unione e non può essere unita in modo pulito.
COMPUTING Lo stato di unione è attualmente calcolato in modo asincrono dal provider SCM upstream.

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.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌