MCP Tools Reference: developerconnect.googleapis.com

ツール: fetch-repo-commit

Git リポジトリから特定の commit の詳細を取得します。FULL ビューで行単位のパッチハンクを取得するには、path_filters（すべてのファイルの場合は ['**'] など）を渡します。

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

入力スキーマ

FetchGitRepositoryLinkCommit のリクエスト メッセージ。

FetchGitRepositoryLinkCommitRequest

JSON 表現 
{
  "name": string,
  "commitSha": string,
  "view": enum (CommitView),
  "pathFilters": [
    string
  ]
}
フィールド
name

string

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

string

必須。commit SHA、またはシンボリック リビジョン（ブランチ名、タグ、Git 参照など）。
view

enum (CommitView)

省略可。レスポンスで返される commit の詳細のレベル。指定しない場合のデフォルトは FULL です。FULL ビューでは、files メタデータ（パスとステータス）が返されます。ラインパッチ ハンクを入力するには、path_filters も指定する必要があります。
pathFilters[]

string

省略可。返されるファイルをフィルタするパスパターンまたは正確なパス（FULL ビューでのみ適用可能）。path_filters が指定されている場合、一致するすべてのファイルに FileDiff.patch が入力されます（変更されたすべてのファイルのパッチを含めるには、["**"] を使用します）。path_filters が省略されているか空の場合、FileDiff の完全なリストがパッチ差分なしで返されます（FileDiff.patch は空です）。

CommitView

レスポンスで返される commit の詳細のレベル。

列挙型
COMMIT_VIEW_UNSPECIFIED 指定しない場合、デフォルトは BASIC です。
BASIC 基本ビュー。commit メタデータを返しますが、ファイル差分は返しません。
FULL 完全なビュー。commit メタデータとファイル差分を返します。

出力スキーマ

FetchGitRepositoryLinkCommit のレスポンス メッセージ。

FetchGitRepositoryLinkCommitResponse

JSON 表現 
{
  "commit": {
    object (SCMCommit)
  },
  "files": [
    {
      object (FileDiff)
    }
  ]
}
フィールド
commit

object (SCMCommit)

commit のメタデータ。
files[]

object (FileDiff)

ファイルの変更とパッチの差分のリスト。ビューが BASIC の場合は省略されます。パッチ差分（FileDiff.patch）は、リクエストで path_filters が指定されている場合にのみ入力されます。

SCMCommit

JSON 表現 
{
  "sha": string,
  "message": string,
  "author": string,
  "authorEmail": string,
  "commitTime": string,
  "url": string
}
フィールド
sha

string

40 文字の完全な SCM commit SHA。
message

string

commit メッセージのテキスト。
author

string

作成者の表示名。
authorEmail

string

作成者のメールアドレス。
commitTime

string (Timestamp format)

commit が作成されたときのタイムスタンプ。

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

string

この commit の SCM プロバイダの 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 にする必要があります（両端を含む）。

FileDiff

JSON 表現 
{
  "path": string,
  "status": string,
  "patch": string
}
フィールド
path

string

リポジトリ内のファイルへの相対パス。
status

string

変更のステータス: 「ADDED」、「MODIFIED」、「REMOVED」、「RENAMED」。
patch

string

ファイルの標準の統合差分パッチハンク。リクエストで path_filters が指定されている場合にのみ入力されます。それ以外の場合は空です。

ツールのアノテーション

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

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

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

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