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

输入架构

用于请求 GitRepositoryLink 列表的消息

ListGitRepositoryLinksRequest

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

字段
parent	string 必需。ListGitRepositoryLinksRequest 的父级值。
pageSize	integer 可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
pageToken	string 可选。标识服务器应返回的结果页面的令牌。
filter	string 可选。过滤结果。
orderBy	string 可选。有关如何对结果进行排序的提示。

输出架构

对列出 GitRepositoryLink 的回答消息。

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 标识符。代码库的资源名称，格式为 projects/*/locations/*/connections/*/gitRepositoryLinks/*。
cloneUri	string 必需。Git 克隆 URI。
createTime	string (Timestamp format) 仅限输出。创建时间戳。 采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 分配的唯一标识符。
webhookId	string 仅限输出。为代码库创建的 webhook 的外部 ID。
gitProxyUri	string 仅限输出。用于通过 Git 代理访问关联代码库的 URI。仅当为连接启用了 Git 代理时，系统才会填充此字段。

时间戳

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

字段
seconds	string (int64 format) 表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值，对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z）。
nanos	integer 秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 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，则该工具只能与内部实体交互。例如，网页搜索工具是开放世界，而记忆工具不是开放世界。

破坏性提示：❌ | 等幂性提示：✅ | 只读提示：✅ | 开放世界提示：❌