MCP Tools Reference: developerconnect.googleapis.com

Ferramenta: diff-repo-commit

Receba a diferença entre dois commits em um repositório Git. Para recuperar hunks de patch linha por linha, transmita path_filters (por exemplo, ['**'] para todos os arquivos).

O exemplo de código abaixo mostra como usar curl para chamar a ferramenta MCP diff-repo-commit.

Solicitação 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": "diff-repo-commit",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para DiffGitRepositoryLinkCommit.

DiffGitRepositoryLinkCommitRequest

Representação JSON 
{
  "name": string,
  "baseSha": string,
  "headSha": string,
  "pathFilters": [
    string
  ]
}
Campos
name

string

Obrigatório. O nome do recurso do GitRepositoryLink.
baseSha

string

Obrigatório. O SHA ou ref do commit de base.
headSha

string

Obrigatório. O SHA ou ref do commit principal.
pathFilters[]

string

Opcional. Padrões de caminho ou caminhos exatos para filtrar os arquivos retornados. Quando path_filters é especificado, FileDiff.patch é preenchido para todos os arquivos correspondentes (use ["**"] para incluir patches para todos os arquivos alterados). Quando path_filters é omitido ou está vazio, a lista completa de FileDiff é retornada sem diferenças de patch (FileDiff.patch está vazio).

Esquema de saída

Mensagem de resposta para DiffGitRepositoryLinkCommit.

DiffGitRepositoryLinkCommitResponse

Representação JSON 
{
  "files": [
    {
      object (FileDiff)
    }
  ]
}
Campos
files[]

object (FileDiff)

A diferença de arquivo extraída da diferença unificada.

FileDiff

Representação JSON 
{
  "path": string,
  "status": string,
  "patch": string
}
Campos
path

string

Caminho relativo para o arquivo no repositório.
status

string

Status da mudança: "ADDED", "MODIFIED", "REMOVED", "RENAMED".
patch

string

Hunk de patch de diff unificado padrão para o arquivo. Preenchido apenas quando path_filters é especificado na solicitação. Caso contrário, fica vazio.

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas:

  • readOnlyHint: se for verdadeiro, a ferramenta não modifica o ambiente. Padrão: false.
  • destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. Padrão: false.
  • openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de jogos de mundo aberto: ❌