MCP Tools Reference: developerconnect.googleapis.com

도구: fetch-repo-pull-request-list

Git 저장소에서 pull 요청 목록을 가져옵니다.

다음 코드 샘플은 curl를 사용하여 fetch-repo-pull-request-list 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-pull-request-list",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

FetchGitRepositoryLinkPullRequestList 요청 메시지입니다.

FetchGitRepositoryLinkPullRequestListRequest

JSON 표현 
{
  "name": string,
  "filter": string,
  "pageSize": integer,
  "pageToken": string
}
필드
name

string

필수 입력란입니다. projects/*/locations/*/connections/*/gitRepositoryLinks/* 형식의 GitRepositoryLink 리소스 이름입니다.
filter

string

(선택사항) 응답에 반환된 pull 요청을 필터링하는 필터 표현식입니다. state에 대한 단일 같음 비교만 지원됩니다(예: state = "OPEN"). 지원되는 값은 OPEN, CLOSED, MERGED입니다. DECLINED는 pull 요청 거부를 지원하는 SCM 제공업체에만 지원되며 GitHub, GitHub Enterprise, GitLab, GitLab Enterprise에 대해 INVALID_ARGUMENT를 반환합니다. 다른 값이나 표현식은 INVALID_ARGUMENT를 반환합니다. 지정하지 않으면 기본값은 state = "OPEN"입니다.
pageSize

integer

(선택사항) 목록에 반환할 결과 수입니다. 기본값은 20입니다. 최댓값은 100입니다. 더 많은 결과를 사용할 수 있는 경우에도 페이지에 page_size개 미만의 결과가 포함될 수 있습니다. next_page_token를 사용하여 더 많은 페이지를 확인하세요.
pageToken

string

(선택사항) 이전 FetchGitRepositoryLinkPullRequestList 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

출력 스키마

FetchGitRepositoryLinkPullRequestList의 응답 메시지입니다.

FetchGitRepositoryLinkPullRequestListResponse

JSON 표현 
{
  "pullRequests": [
    {
      object (PullRequest)
    }
  ],
  "nextPageToken": string
}
필드
pullRequests[]

object (PullRequest)

pull 요청 목록입니다.
nextPageToken

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

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

필수 입력란입니다. 헤드 브랜치의 소스 커밋 SHA입니다.
baseRef

string

필수 입력란입니다. 기본 브랜치의 대상 커밋 SHA입니다.
author

string

출력 전용입니다. 작성자의 사용자 이름입니다.
createTime

string (Timestamp format)

출력 전용입니다. PR이 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. PR이 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
mergeTime

string (Timestamp format)

출력 전용입니다. PR이 병합된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
closeTime

string (Timestamp format)

출력 전용입니다. PR이 종료된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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 제공업체에만 설정됩니다. 병합되지 않고 종료된 pull 요청이 CLOSED인 GitHub, GitHub Enterprise, GitLab, GitLab Enterprise에는 설정되지 않습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

유닉스 시간 1970-01-01T00:00:00Z 이후 경과된 UTC 시간을 초 단위로 나타냅니다. -62135596800~253402300799(양 끝값 포함) 사이여야 합니다(0001-01-01T00:00:00Z~9999-12-31T23:59:59Z에 해당).
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초를 대체하지 않습니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 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 Git 충돌 없이 pull 요청을 깔끔하게 병합할 수 있습니다.
CONFLICTING pull 요청에 병합 충돌이 있어 깔끔하게 병합할 수 없습니다.
COMPUTING 병합 가능 상태는 현재 업스트림 SCM 제공업체에서 비동기식으로 계산되고 있습니다.

도구 주석

도구 주석은 MCP 클라이언트에 전송되어 특정 도구의 기본 위험을 설명합니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 확인 메시지가 사용자에게 전송될 수 있는 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 정의됩니다.

  • readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true인 경우 도구에서 파괴적인 작업을 수행할 수 있습니다. false이면 도구는 추가 작업만 수행할 수 있습니다. 기본값은 true입니다.
  • idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true인 경우 도구는 외부 항목의 '오픈 월드'와 상호작용할 수 있습니다. false이면 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

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