MCP Tools Reference: developerconnect.googleapis.com

Herramienta: diff-repo-commit

Obtener la diferencia entre dos confirmaciones en un repositorio de Git Para recuperar fragmentos de parches línea por línea, pasa path_filters (por ejemplo, ['**'] para todos los archivos).

En la siguiente muestra de código, se indica cómo usar curl para llamar a la herramienta de MCP diff-repo-commit.

Solicitud de 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

Mensaje de solicitud para DiffGitRepositoryLinkCommit.

DiffGitRepositoryLinkCommitRequest

Representación JSON 
{
  "name": string,
  "baseSha": string,
  "headSha": string,
  "pathFilters": [
    string
  ]
}
Campos
name

string

Obligatorio. Es el nombre del recurso de GitRepositoryLink.
baseSha

string

Obligatorio. Es el SHA o la referencia de confirmación base.
headSha

string

Obligatorio. Es el SHA o la referencia de la confirmación principal.
pathFilters[]

string

Es opcional. Son patrones de ruta de acceso o rutas de acceso exactas para filtrar los archivos devueltos. Cuando se especifica path_filters, se propaga FileDiff.patch para todos los archivos que coinciden (usa ["**"] para incluir parches para todos los archivos modificados). Cuando se omite path_filters o está vacío, se devuelve la lista completa de FileDiff sin diferencias de parches (FileDiff.patch está vacío).

Esquema de salida

Es el mensaje de respuesta para DiffGitRepositoryLinkCommit.

DiffGitRepositoryLinkCommitResponse

Representación JSON 
{
  "files": [
    {
      object (FileDiff)
    }
  ]
}
Campos
files[]

object (FileDiff)

Es la diferencia de archivos extraída de la diferencia unificada.

FileDiff

Representación JSON 
{
  "path": string,
  "status": string,
  "patch": string
}
Campos
path

string

Es la ruta de acceso relativa al archivo en el repositorio.
status

string

Estado del cambio: "ADDED", "MODIFIED", "REMOVED", "RENAMED".
patch

string

Es el fragmento de parche de diferencias unificado estándar para el archivo. Solo se propaga cuando se especifica path_filters en la solicitud; de lo contrario, está vacío.

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, las siguientes sugerencias booleanas se definen de la siguiente manera:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia de destructivo: ❌ | Sugerencia de idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌