MCP Tools Reference: developerconnect.googleapis.com

工具：create-repo-link

在指定專案和位置建立新的 GitRepositoryLink。

下列程式碼範例說明如何使用 curl 呼叫 create-repo-link 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": "create-repo-link", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }'

輸入內容的結構定義

建立 GitRepositoryLink 的訊息

CreateGitRepositoryLinkRequest

JSON 表示法
{ "parent": string, "gitRepositoryLink": { object (GitRepositoryLink) }, "gitRepositoryLinkId": string, "requestId": string, "validateOnly": boolean }

欄位
parent	string 這是必要旗標，上層的值。
gitRepositoryLink	object (GitRepositoryLink) 這是必要旗標，正在建立的資源
gitRepositoryLinkId	string 這是必要旗標，存放區要使用的 ID，會成為存放區資源名稱的最後一個部分。這個 ID 在連線中不得重複。允許英數字元和下列任一字元：-._~%!$&'()*+,;=@。
requestId	string 選用。選用的要求 ID，用於識別要求。請指定專屬要求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證從第一次要求起至少 60 分鐘內有效。 舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同的要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果是，則會忽略第二個要求。避免用戶端不小心建立重複的承諾使用合約。 要求 ID 必須是有效的 UUID，但不得為零 UUID (00000000-0000-0000-0000-000000000000)。
validateOnly	boolean 選用。如果設定，則驗證要求，但不要實際發布。

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

輸出內容的結構定義

這個資源代表某個網路 API 呼叫所造成長時間執行的作業。

作業

JSON 表示法
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field result can be only one of the following: "error": { object (Status) }, "response": { "@type": string, field1: ..., ... } // End of list of possible types for union field result. }

欄位
name	string 伺服器指派的名稱，而且只有在當初傳回這個名稱的服務中是不重複項目。如果您使用預設的 HTTP 對應，則 name 應該是以 operations/{unique_id} 結尾的資源名稱。
metadata	object 與作業相關聯的服務專屬中繼資料，通常包含進度資訊和常用中繼資料 (例如建立時間)。部分服務可能不會提供這類中繼資料。凡是會傳回長時間執行的作業的方法，都應記錄中繼資料類型 (如有)。 包含任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。例如 { "id": 1234, "@type": "types.example.com/standard/id" }。
done	boolean 如果值為 false，代表作業仍在執行中。如果值為 true，代表作業已完成，系統會顯示 error 或 response 的執行結果。
聯集欄位 result。這是作業的執行結果，可能為 error，或是有效的 response。如果 done == false，系統不會將結果設定為 error 或 response。如果 done == true，系統只能將結果設定為 error 或 response。部分服務可能不會提供結果。result 只能是下列其中一個設定：
error	object (Status) 作業失敗或取消時顯示的錯誤結果。
response	object 作業執行成功時的一般回應。如果原始方法在執行成功時沒有傳回資料 (例如 Delete)，則回應為 google.protobuf.Empty。如果原始方法是標準的 Get/Create/Update，回應則應該為資源。如果是其他方法，回應必須包含類型 XxxResponse，其中 Xxx 是原始方法的名稱。舉例來說，如果原始方法的名稱為 TakeSnapshot()，您就能推測出回應類型應該是 TakeSnapshotResponse。 包含任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。範例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

不限

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

欄位
typeUrl	string 使用 URI 參照來識別序列化 Protobuf 訊息的類型，其中包含以斜線結尾的前置字串，以及完整類型名稱。 範例：type.googleapis.com/google.protobuf.StringValue 這個字串必須包含至少一個 / 字元，且最後一個 / 後方的內容必須是標準格式的完整類型名稱，開頭不得為點號。請勿在這些 URI 參照上寫入配置，以免用戶端嘗試與其聯絡。 前置字串可任意指定，Protobuf 實作項目應直接移除最後一個 / 之前的所有內容 (包括 )，以識別類型。type.googleapis.com/ 是常見的預設前置字元，某些舊版實作項目需要使用。這個前置字串不代表類型的來源，且包含這個前置字串的 URI 不會回應任何要求。 所有類型網址字串都必須是合法的 URI 參照，且有額外限制 (文字格式)，參照內容只能包含英數字元、百分比編碼逸出字元，以及下列字元集中的字元 (不含外側反引號)：/-.~_!$&()*+,;=。雖然我們允許百分比編碼，但實作時不應取消逸出，以免與現有剖析器混淆。例如，type.googleapis.com%2FFoo 應遭拒。 在 Any 的原始設計中，我們曾考慮在這些類型網址啟動類型解析服務，但 Protobuf 從未實作這項服務，並認為與這些網址通訊會造成問題，且可能引發安全性問題。請勿嘗試輸入網址。
value	string (bytes format) 保留 type_url 所述類型的 Protobuf 序列化。 Base64 編碼字串。

狀態

JSON 表示法
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] }

欄位
code	integer 狀態碼，應為 google.rpc.Code 的列舉值。
message	string 向開發人員顯示的錯誤訊息，應以英文呈現。所有面向使用者的錯誤訊息都應經過本地化，並透過 google.rpc.Status.details 欄位傳送，或是由用戶端加以本地化。
details[]	object 包含錯誤詳細資料的訊息清單。這是供 API 使用的一組常用訊息類型。 包含任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。範例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

工具註解

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

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

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

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