MCP Tools Reference: developerconnect.googleapis.com

Alat: fetch-repo-file-blame

Mengambil informasi blame untuk file tertentu di repositori Git.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP fetch-repo-file-blame.

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

Skema Input

Pesan permintaan untuk FetchGitRepositoryLinkFileBlame.

FetchGitRepositoryLinkFileBlameRequest

Representasi JSON 
{
  "name": string,
  "ref": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer
}
Kolom
name

string

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

string

Wajib. SHA commit SCM, atau revisi simbolis (misalnya, nama cabang, tag) yang menjadi sumber pengambilan blame.
path

string

Wajib. Jalur file dalam repositori.
firstLine

integer

Opsional. Nomor baris awal berindeks 1 dari rentang yang akan disalahkan (inklusif). Jika tidak ditentukan, blame akan dimulai pada baris 1.
lastLine

integer

Opsional. Nomor baris akhir berindeks 1 dari rentang yang akan disalahkan (inklusif). Jika tidak ditentukan, blame akan diperluas hingga akhir file.

Skema Output

Pesan respons untuk FetchGitRepositoryLinkFileBlame.

FetchGitRepositoryLinkFileBlameResponse

Representasi JSON 
{
  "ranges": [
    {
      object (BlameRange)
    }
  ]
}
Kolom
ranges[]

object (BlameRange)

Daftar rentang blame untuk file.

BlameRange

Representasi JSON 
{
  "firstLine": integer,
  "lastLine": integer,
  "commit": {
    object (SCMCommit)
  }
}
Kolom
firstLine

integer

Nomor baris awal rentang yang diindeks 1 (inklusif).
lastLine

integer

Nomor baris akhir rentang yang diindeks 1 (inklusif).
commit

object (SCMCommit)

Metadata commit untuk rentang baris ini.

SCMCommit

Representasi JSON 
{
  "sha": string,
  "message": string,
  "author": string,
  "authorEmail": string,
  "commitTime": string,
  "url": string
}
Kolom
sha

string

SHA commit SCM 40 karakter lengkap.
message

string

Teks pesan commit.
author

string

Nama tampilan penulis.
authorEmail

string

Alamat email penulis.
commitTime

string (Timestamp format)

Stempel waktu saat commit dibuat.

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".
url

string

Link URL HTML penyedia SCM untuk commit ini.

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.

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: ❌