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 将成为代码库资源名称的最后一个组成部分。此 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 标识符。代码库的资源名称，格式为 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

输出架构

此资源表示由网络 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 引用上写入 scheme，以免客户端尝试与其联系。 前缀是任意的，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，则该工具只能与内部实体交互。例如，网页搜索工具是开放世界，而记忆工具不是开放世界。

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