MCP Tools Reference: developerconnect.googleapis.com

Alat: fetch-repo-pull-request-list

Mengambil daftar permintaan pull dari repositori Git.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP fetch-repo-pull-request-list.

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

Skema Input

Pesan permintaan untuk FetchGitRepositoryLinkPullRequestList.

FetchGitRepositoryLinkPullRequestListRequest

Representasi JSON 
{
  "name": string,
  "filter": string,
  "pageSize": integer,
  "pageToken": string
}
Kolom
name

string

Wajib. Nama resource GitRepositoryLink dalam format projects/*/locations/*/connections/*/gitRepositoryLinks/*.
filter

string

Opsional. Ekspresi filter yang memfilter permintaan pull yang ditampilkan dalam respons. Hanya satu perbandingan kesetaraan pada state yang didukung, misalnya state = "OPEN". Nilai yang didukung adalah OPEN, CLOSED, dan MERGED. DECLINED hanya didukung untuk penyedia SCM yang mendukung penolakan permintaan pull, dan menampilkan INVALID_ARGUMENT untuk GitHub, GitHub Enterprise, GitLab, dan GitLab Enterprise. Nilai atau ekspresi lainnya menampilkan INVALID_ARGUMENT. Setelan defaultnya adalah state = "OPEN" jika tidak ditentukan.
pageSize

integer

Opsional. Jumlah hasil yang akan ditampilkan dalam daftar. Defaultnya adalah 20. Maksimumnya adalah 100. Halaman mungkin berisi kurang dari page_size hasil meskipun ada lebih banyak hasil yang tersedia; gunakan next_page_token untuk memeriksa halaman lainnya.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan FetchGitRepositoryLinkPullRequestList sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Skema Output

Pesan respons untuk FetchGitRepositoryLinkPullRequestList.

FetchGitRepositoryLinkPullRequestListResponse

Representasi JSON 
{
  "pullRequests": [
    {
      object (PullRequest)
    }
  ],
  "nextPageToken": string
}
Kolom
pullRequests[]

object (PullRequest)

Daftar permintaan pull.
nextPageToken

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

PullRequest

Representasi 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
}
Kolom
id

string

Wajib. ID PR.
title

string

Wajib. Judul PR.
body

string

Opsional. Deskripsi isi PR.
headRef

string

Wajib. SHA commit sumber dari cabang head.
baseRef

string

Wajib. SHA commit target dari cabang dasar.
author

string

Hanya output. Nama pengguna penulis.
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan PR.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Kapan PR diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
mergeTime

string (Timestamp format)

Hanya output. Saat PR digabungkan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
closeTime

string (Timestamp format)

Hanya output. Waktu PR ditutup.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
declineTime

string (Timestamp format)

Hanya output. Saat PR ditolak. Hanya ditetapkan untuk penyedia SCM yang mendukung penolakan permintaan pull. Tidak pernah ditetapkan untuk GitHub, GitHub Enterprise, GitLab, atau GitLab Enterprise, yang permintaan pull-nya ditutup tanpa digabungkan adalah CLOSED.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
state

enum (State)

Hanya output. Status PR saat ini.
mergeability

enum (Mergeability)

Hanya output. Status penggabungan permintaan pull.
htmlUrl

string

Hanya output. URL HTML permintaan pull di penyedia SCM.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nano non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

Negara bagian/Provinsi

Status PR.

Enum
STATE_UNSPECIFIED Nilai default.
OPEN PR terbuka.
CLOSED PR ditutup.
MERGED PR digabungkan.
DECLINED PR ditolak. Hanya digunakan oleh penyedia SCM yang mendukung penolakan permintaan pull. Tidak pernah digunakan untuk GitHub, GitHub Enterprise, GitLab, atau GitLab Enterprise, yang permintaan pull-nya ditutup tanpa digabungkan adalah CLOSED.

Kemudahan penggabungan

Status penggabungan permintaan pull.

Enum
MERGEABILITY_UNSPECIFIED Status penggabungan tidak ditentukan.
MERGEABLE Permintaan pull dapat digabungkan dengan rapi tanpa konflik Git.
CONFLICTING Permintaan pull memiliki konflik penggabungan dan tidak dapat digabungkan dengan baik.
COMPUTING Status penggabungan saat ini sedang dihitung secara asinkron oleh penyedia SCM upstream.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk tersebut dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim kepada pengguna.

Bersama dengan string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan aditif. Default: true.
  • idempotentHint: Jika benar, memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'open world' entitas eksternal. Jika salah, alat hanya dapat berinteraksi dengan entity internal. Misalnya, alat penelusuran web akan bersifat open world, sedangkan alat memori tidak akan bersifat open world.

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