MCP Tools Reference: developerconnect.googleapis.com

ツール: open-repo-pull-request

リモート SCM リポジトリで pull リクエストを開きます。

次のコードサンプルは、curl を使用して open-repo-pull-request 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": "open-repo-pull-request",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

SCM pull リクエストを開くためのメッセージ。

OpenGitRepositoryLinkPullRequestRequest

JSON 表現 
{
  "name": string,
  "pullRequest": {
    object (PullRequest)
  }
}
フィールド
name

string

必須。GitRepositoryLink リソース名（projects/*/locations/*/connections/*/gitRepositoryLinks/* の形式）。
pullRequest

object (PullRequest)

必須。開く pull リクエストの詳細。使用される入力フィールド: title、body、head_ref、base_ref。

PullRequest

JSON 表現 
{
  "id": string,
  "title": string,
  "body": string,
  "headRef": string,
  "baseRef": string,
  "author": string,
  "createTime": string,
  "updateTime": string,
  "mergeTime": string,
  "closeTime": string,
  "declineTime": string,
  "state": enum (State),
  "mergeability": enum (Mergeability),
  "htmlUrl": string
}
フィールド
id

string

必須。PR の ID。
title

string

必須。PR のタイトル。
body

string

省略可。PR の本文の説明。
headRef

string

必須。ヘッドブランチのソース commit SHA。
baseRef

string

必須。ベースブランチのターゲット commit SHA。
author

string

出力専用。作成者のユーザー名。
createTime

string (Timestamp format)

出力専用。PR が作成された日時。

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)

出力専用。PR が更新された日時。

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"。
mergeTime

string (Timestamp format)

出力専用。PR がマージされた日時。

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"。
closeTime

string (Timestamp format)

出力専用。PR がクローズされた日時。

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"。
declineTime

string (Timestamp format)

出力専用。PR が不承認となった場合。pull リクエストの拒否をサポートする SCM プロバイダにのみ設定されます。GitHub、GitHub Enterprise、GitLab、GitLab Enterprise では設定されません。これらのサービスでは、マージされずにクローズされた pull リクエストは CLOSED になります。

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"。
state

enum (State)

出力専用。PR の現在の状態。
mergeability

enum (Mergeability)

出力専用。pull リクエストのマージ可能性の状態。
htmlUrl

string

出力専用。SCM プロバイダの pull リクエストの HTML URL。

タイムスタンプ

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0～999,999,999 にする必要があります（両端を含む）。

状態

PR の状態。

列挙型
STATE_UNSPECIFIED デフォルト値。
OPEN PR が開いている。
CLOSED PR がクローズされました。
MERGED PR がマージされます。
DECLINED PR が不承認となった。pull リクエストの拒否をサポートする SCM プロバイダでのみ使用されます。GitHub、GitHub Enterprise、GitLab、GitLab Enterprise では使用されません。これらのサービスでは、マージされずにクローズされた pull リクエストは CLOSED になります。

マージ可能性

pull リクエストのマージ可能性の状態。

列挙型
MERGEABILITY_UNSPECIFIED マージ可能性の状態が指定されていません。
MERGEABLE pull リクエストは、Git の競合なしでクリーンにマージできます。
CONFLICTING pull リクエストにマージの競合があり、クリーンにマージできません。
COMPUTING マージ可能性の状態は、現在、アップストリーム SCM プロバイダによって非同期で計算されています。

出力スキーマ

SCM pull リクエストを表すメッセージ。

PullRequest

JSON 表現 
{
  "id": string,
  "title": string,
  "body": string,
  "headRef": string,
  "baseRef": string,
  "author": string,
  "createTime": string,
  "updateTime": string,
  "mergeTime": string,
  "closeTime": string,
  "declineTime": string,
  "state": enum (State),
  "mergeability": enum (Mergeability),
  "htmlUrl": string
}
フィールド
id

string

必須。PR の ID。
title

string

必須。PR のタイトル。
body

string

省略可。PR の本文の説明。
headRef

string

必須。ヘッドブランチのソース commit SHA。
baseRef

string

必須。ベースブランチのターゲット commit SHA。
author

string

出力専用。作成者のユーザー名。
createTime

string (Timestamp format)

出力専用。PR が作成された日時。

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)

出力専用。PR が更新された日時。

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"。
mergeTime

string (Timestamp format)

出力専用。PR がマージされた日時。

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"。
closeTime

string (Timestamp format)

出力専用。PR がクローズされた日時。

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"。
declineTime

string (Timestamp format)

出力専用。PR が不承認となった場合。pull リクエストの拒否をサポートする SCM プロバイダにのみ設定されます。GitHub、GitHub Enterprise、GitLab、GitLab Enterprise では設定されません。これらのサービスでは、マージされずにクローズされた pull リクエストは CLOSED になります。

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"。
state

enum (State)

出力専用。PR の現在の状態。
mergeability

enum (Mergeability)

出力専用。pull リクエストのマージ可能性の状態。
htmlUrl

string

出力専用。SCM プロバイダの pull リクエストの HTML URL。

タイムスタンプ

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0～999,999,999 にする必要があります（両端を含む）。

状態

PR の状態。

列挙型
STATE_UNSPECIFIED デフォルト値。
OPEN PR が開いている。
CLOSED PR がクローズされました。
MERGED PR がマージされます。
DECLINED PR が不承認となった。pull リクエストの拒否をサポートする SCM プロバイダでのみ使用されます。GitHub、GitHub Enterprise、GitLab、GitLab Enterprise では使用されません。これらのサービスでは、マージされずにクローズされた pull リクエストは CLOSED になります。

マージ可能性

pull リクエストのマージ可能性の状態。

列挙型
MERGEABILITY_UNSPECIFIED マージ可能性の状態が指定されていません。
MERGEABLE pull リクエストは、Git の競合なしでクリーンにマージできます。
CONFLICTING pull リクエストにマージの競合があり、クリーンにマージできません。
COMPUTING マージ可能性の状態は、現在、アップストリーム SCM プロバイダによって非同期で計算されています。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントは、これらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値のヒントが定義されています。

  • readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に副次的影響は発生しません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープンワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ❌ | 読み取り専用ヒント: ❌ | オープン ワールド ヒント: ❌