MCP Tools Reference: developerconnect.googleapis.com

工具：list-repo-links

列出連線下的 Git 存放區連結。

下列程式碼範例說明如何使用 curl 呼叫 list-repo-links MCP 工具。

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 }'

輸入內容的結構定義

要求 GitRepositoryLinks 清單的訊息

ListGitRepositoryLinksRequest

JSON 表示法
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string }

欄位
parent	string 這是必要旗標，ListGitRepositoryLinksRequest 的父項值。
pageSize	integer 選用。要求的頁面大小。伺服器傳回的項目數量可能少於要求數量。如未指定，伺服器會選擇適當的預設值。
pageToken	string 選用。用來識別伺服器應傳回哪一頁結果的權杖。
filter	string 選用。篩選結果。
orderBy	string 選用。結果排序方式的提示。

輸出內容的結構定義

列出 GitRepositoryLinks 的回應訊息

ListGitRepositoryLinksResponse

JSON 表示法
{ "gitRepositoryLinks": [ { object (GitRepositoryLink) } ], "nextPageToken": string, "unreachable": [ string ] }

欄位
gitRepositoryLinks[]	object (GitRepositoryLink) GitRepositoryLink 清單。
nextPageToken	string 用來識別伺服器應傳回哪一頁結果的權杖。
unreachable[]	string 無法連線的位置。

GitRepositoryLink

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 }

欄位
name	string ID。存放區的資源名稱，格式為 projects/*/locations/*/connections/*/gitRepositoryLinks/*。
cloneUri	string 這是必要旗標，Git 複製 URI。
createTime	string (Timestamp format) 僅供輸出。建立時間戳記。 使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime	string (Timestamp format) 僅供輸出。更新時間戳記。 使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
deleteTime	string (Timestamp format) 僅供輸出。刪除時間戳記。 使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
labels	map (key: string, value: string) 選用。標籤 (鍵/值組合) 包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
etag	string 選用。這個核對和是由伺服器根據其他欄位的值計算得出，可能會在更新和刪除要求中傳送，確保用戶端在繼續操作前取得最新值。
reconciling	boolean 僅供輸出。在背景設定或更新連線時，請設為 true。
annotations	map (key: string, value: string) 選用。可讓用戶端儲存少量任意資料。 包含 "key": value 組合清單的物件，例如 { "name": "wrench", "mass": "1.3kg", "count": "3" }。
uid	string 僅供輸出。系統指派給 GitRepositoryLink 的專屬 ID。
webhookId	string 僅供輸出。為存放區建立的 Webhook 外部 ID。
gitProxyUri	string 僅供輸出。透過 Git Proxy 存取連結存放區的 URI。只有在連線啟用 Git Proxy 時，系統才會填入這個欄位。

時間戳記

JSON 表示法
{ "seconds": string, "nanos": integer }

欄位
seconds	string (int64 format) 代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 (含) 之間 (對應 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z)。
nanos	integer 以奈秒解析度表示的非負分數秒。這個欄位是時間長度的奈秒部分，而非秒數的替代值。含有分數的負秒值仍須有非負奈秒值，以向前計算時間。必須介於 0 至 999,999,999 之間 (含 0 和 999,999,999)。

LabelsEntry

JSON 表示法
{ "key": string, "value": string }

欄位
key	string
value	string

AnnotationsEntry

JSON 表示法
{ "key": string, "value": string }

欄位
key	string
value	string

工具註解

工具註解會傳送至 MCP 用戶端，說明特定工具的基本風險。大多數用戶端會將這些提示視為不受信任，但可用於決定何時向使用者傳送確認提示。

除了標題字串外，下列布林值提示的定義如下：

• readOnlyHint：如果設為 true，工具不會修改環境。預設值：false。
• destructiveHint：如果為 true，工具可以執行破壞性動作。如果為 false，則工具只能執行附加動作。預設值：true。
• idempotentHint：如果設為 true，則使用相同引數重複呼叫工具，不會對環境造成額外影響。預設值：false。
• openWorldHint：如果設為 true，工具就能與外部實體的「開放世界」互動。如果設為 false，工具只能與內部實體互動。舉例來說，網頁搜尋工具是開放世界，而記憶工具則不是。

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