GitHub MCP Server

Integración fluida con las APIs de GitHub para automatización e interacción en el desarrollo.

Documentación

GitHub MCP Server

El GitHub MCP Server es un servidor de Model Context Protocol (MCP) que proporciona una integración perfecta con las APIs de GitHub, permitiendo capacidades avanzadas de automatización e interacción para desarrolladores y herramientas.

Install with Docker in VS Code Install with Docker in VS Code Insiders

Casos de Uso

  • Automatizar flujos de trabajo y procesos de GitHub.
  • Extraer y analizar datos de repositorios de GitHub.
  • Construir herramientas y aplicaciones impulsadas por IA que interactúen con el ecosistema de GitHub.

Requisitos Previos

  1. Para ejecutar el servidor en un contenedor, necesitarás tener Docker instalado.
  2. Una vez que Docker esté instalado, también necesitarás asegurarte de que Docker esté en ejecución. La imagen es pública; si recibes errores al hacer pull, es posible que tengas un token caducado y necesites docker logout ghcr.io.
  3. Por último, necesitarás Crear un Personal Access Token de GitHub. El servidor MCP puede usar muchas de las APIs de GitHub, así que habilita los permisos que te sientas cómodo otorgando a tus herramientas de IA (para obtener más información sobre los tokens de acceso, consulta la documentación).

Instalación

Uso con VS Code

Para una instalación rápida, usa uno de los botones de instalación con un solo clic en la parte superior de este README. Una vez que completes ese flujo, activa el modo Agente (ubicado junto al campo de entrada de texto de Copilot Chat) y el servidor se iniciará.

Para la instalación manual, agrega el siguiente bloque JSON a tu archivo de Configuración de Usuario (JSON) en VS Code. Puedes hacer esto presionando Ctrl + Shift + P y escribiendo Preferences: Open User Settings (JSON).

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "github_token",
        "description": "GitHub Personal Access Token",
        "password": true
      }
    ],
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "GITHUB_PERSONAL_ACCESS_TOKEN",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
        }
      }
    }
  }
}

Opcionalmente, puedes agregar un ejemplo similar (es decir, sin la clave mcp) a un archivo llamado .vscode/mcp.json en tu espacio de trabajo. Esto te permitirá compartir la configuración con otros.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "github_token",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ],
  "servers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
      }
    }
  }
}

Más información sobre el uso de las herramientas del servidor MCP en la documentación del modo agente de VS Code.

Uso con Claude Desktop

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Compilar desde el código fuente

Si no tienes Docker, puedes usar go build para compilar el binario en el directorio cmd/github-mcp-server, y usar el comando github-mcp-server stdio con la variable de entorno GITHUB_PERSONAL_ACCESS_TOKEN configurada con tu token. Para especificar la ubicación de salida de la compilación, usa la bandera -o. Debes configurar tu servidor para que use el ejecutable compilado como su command. Por ejemplo:

{
  "mcp": {
    "servers": {
      "github": {
        "command": "/path/to/github-mcp-server",
        "args": ["stdio"],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
        }
      }
    }
  }
}

Configuración de Herramientas

El GitHub MCP Server admite habilitar o deshabilitar grupos específicos de funcionalidades mediante la bandera --toolsets. Esto te permite controlar qué capacidades de la API de GitHub están disponibles para tus herramientas de IA. Habilitar solo los conjuntos de herramientas que necesitas puede ayudar al LLM con la selección de herramientas y reducir el tamaño del contexto.

Conjuntos de Herramientas Disponibles

Los siguientes conjuntos de herramientas están disponibles (todos están activados por defecto):

Conjunto de HerramientasDescripción
reposHerramientas relacionadas con repositorios (operaciones de archivos, ramas, commits)
issuesHerramientas relacionadas con issues (crear, leer, actualizar, comentar)
usersCualquier cosa relacionada con Usuarios de GitHub
pull_requestsOperaciones de pull requests (crear, fusionar, revisar)
code_securityAlertas de code scanning y características de seguridad
experimentsCaracterísticas experimentales (no consideradas estables)

Especificando Conjuntos de Herramientas

Para especificar los conjuntos de herramientas que deseas que estén disponibles para el LLM, puedes pasar una lista de permitidos de dos maneras:

  1. Usando Argumento de Línea de Comandos:

    github-mcp-server --toolsets repos,issues,pull_requests,code_security
    
  2. Usando Variable de Entorno:

    GITHUB_TOOLSETS="repos,issues,pull_requests,code_security" ./github-mcp-server
    

La variable de entorno GITHUB_TOOLSETS tiene prioridad sobre el argumento de línea de comandos si ambos se proporcionan.

Uso de Conjuntos de Herramientas con Docker

Cuando uses Docker, puedes pasar los conjuntos de herramientas como variables de entorno:

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_TOOLSETS="repos,issues,pull_requests,code_security,experiments" \
  ghcr.io/github/github-mcp-server

El Conjunto de Herramientas "all"

El conjunto de herramientas especial all se puede proporcionar para habilitar todos los conjuntos de herramientas disponibles independientemente de cualquier otra configuración:

./github-mcp-server --toolsets all

O usando la variable de entorno:

GITHUB_TOOLSETS="all" ./github-mcp-server

Descubrimiento Dinámico de Herramientas

Nota: Esta característica está actualmente en beta y puede no estar disponible en todos los entornos. Por favor, pruébala y háznos saber si encuentras algún problema.

En lugar de comenzar con todas las herramientas habilitadas, puedes activar el descubrimiento dinámico de conjuntos de herramientas. Los conjuntos de herramientas dinámicos permiten al host MCP listar y habilitar conjuntos de herramientas en respuesta a un mensaje del usuario. Esto debería ayudar a evitar situaciones donde el modelo se confunde por la gran cantidad de herramientas disponibles.

Uso del Descubrimiento Dinámico de Herramientas

Cuando uses el binario, puedes pasar la bandera --dynamic-toolsets.

./github-mcp-server --dynamic-toolsets

Cuando uses Docker, puedes pasar los conjuntos de herramientas como variables de entorno:

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_DYNAMIC_TOOLSETS=1 \
  ghcr.io/github/github-mcp-server

GitHub Enterprise Server y Enterprise Cloud con residencia de datos (ghe.com)

La bandera --gh-host y la variable de entorno GITHUB_HOST se pueden usar para configurar el nombre de host para GitHub Enterprise Server o GitHub Enterprise Cloud con residencia de datos.

  • Para GitHub Enterprise Server, prefija el nombre de host con el esquema de URI https://, ya que de lo contrario se establece por defecto a http://, que GitHub Enterprise Server no admite.
  • Para GitHub Enterprise Cloud con residencia de datos, usa https://YOURSUBDOMAIN.ghe.com como nombre de host.
"github": {
    "command": "docker",
    "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "GITHUB_PERSONAL_ACCESS_TOKEN",
    "-e",
    "GITHUB_HOST",
    "ghcr.io/github/github-mcp-server"
    ],
    "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
        "GITHUB_HOST": "https://<your GHES or ghe.com domain name>"
    }
}

i18n / Sobrescribir Descripciones

Las descripciones de las herramientas se pueden sobrescribir creando un archivo github-mcp-server-config.json en el mismo directorio que el binario.

El archivo debe contener un objeto JSON con los nombres de las herramientas como claves y las nuevas descripciones como valores. Por ejemplo:

{
  "TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "an alternative description",
  "TOOL_CREATE_BRANCH_DESCRIPTION": "Create a new branch in a GitHub repository"
}

Puedes crear una exportación de las traducciones actuales ejecutando el binario con la bandera --export-translations.

Esta bandera conservará cualquier traducción/sobrescritura que hayas realizado, mientras agrega cualquier traducción nueva que se haya agregado al binario desde la última vez que exportaste.

./github-mcp-server --export-translations
cat github-mcp-server-config.json

También puedes usar variables de entorno para sobrescribir las descripciones. Los nombres de las variables de entorno son los mismos que las claves en el archivo JSON, prefijados con GITHUB_MCP_ y todo en mayúsculas.

Por ejemplo, para sobrescribir la herramienta TOOL_ADD_ISSUE_COMMENT_DESCRIPTION, puedes configurar la siguiente variable de entorno:

export GITHUB_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION="an alternative description"

Herramientas

Usuarios

  • get_me - Obtener detalles del usuario autenticado
    • No se requieren parámetros

Issues

  • get_issue - Obtiene el contenido de un issue dentro de un repositorio

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • issue_number: Número del issue (number, requerido)
  • get_issue_comments - Obtener comentarios para un issue de GitHub

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • issue_number: Número del issue (number, requerido)
  • create_issue - Crear un nuevo issue en un repositorio de GitHub

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • title: Título del issue (string, requerido)
    • body: Contenido del cuerpo del issue (string, opcional)
    • assignees: Nombres de usuario para asignar a este issue (string[], opcional)
    • labels: Etiquetas para aplicar a este issue (string[], opcional)
  • add_issue_comment - Agregar un comentario a un issue

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • issue_number: Número del issue (number, requerido)
    • body: Texto del comentario (string, requerido)
  • list_issues - Listar y filtrar issues del repositorio

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • state: Filtrar por estado ('open', 'closed', 'all') (string, opcional)
    • labels: Etiquetas para filtrar (string[], opcional)
    • sort: Ordenar por ('created', 'updated', 'comments') (string, opcional)
    • direction: Dirección de ordenamiento ('asc', 'desc') (string, opcional)
    • since: Filtrar por fecha (marca de tiempo ISO 8601) (string, opcional)
    • page: Número de página (number, opcional)
    • perPage: Resultados por página (number, opcional)
  • update_issue - Actualizar un issue existente en un repositorio de GitHub

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • issue_number: Número del issue a actualizar (number, requerido)
    • title: Nuevo título (string, opcional)
    • body: Nueva descripción (string, opcional)
    • state: Nuevo estado ('open' o 'closed') (string, opcional)
    • labels: Nuevas etiquetas (string[], opcional)
    • assignees: Nuevos asignados (string[], opcional)
    • milestone: Nuevo número de hito (number, opcional)
  • search_issues - Buscar issues y pull requests

    • query: Consulta de búsqueda (string, requerido)
    • sort: Campo de ordenamiento (string, opcional)
    • order: Orden de ordenamiento (string, opcional)
    • page: Número de página (number, opcional)
    • perPage: Resultados por página (number, opcional)

Pull Requests

  • get_pull_request - Obtener detalles de un pull request específico

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • pullNumber: Número del pull request (number, requerido)
  • list_pull_requests - Listar y filtrar pull requests del repositorio

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • state: Estado del PR (string, opcional)
    • sort: Campo de ordenamiento (string, opcional)
    • direction: Dirección de ordenamiento (string, opcional)
    • perPage: Resultados por página (number, opcional)
    • page: Número de página (number, opcional)
  • merge_pull_request - Fusionar un pull request

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • pullNumber: Número del pull request (number, requerido)
    • commit_title: Título para el commit de fusión (string, opcional)
    • commit_message: Mensaje para el commit de fusión (string, opcional)
    • merge_method: Método de fusión (string, opcional)
  • get_pull_request_files - Obtener la lista de archivos modificados en un pull request

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • pullNumber: Número del pull request (number, requerido)
  • get_pull_request_status - Obtener el estado combinado de todas las verificaciones de estado para un pull request

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • pullNumber: Número del pull request (number, requerido)
  • update_pull_request_branch - Actualizar una rama de pull request con los últimos cambios de la rama base

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • pullNumber: Número del pull request (number, requerido)
    • expectedHeadSha: El SHA esperado de la referencia HEAD del pull request (string, opcional)
  • get_pull_request_comments - Obtener los comentarios de revisión en un pull request

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • pullNumber: Número del pull request (number, requerido)
  • get_pull_request_reviews - Obtener las revisiones en un pull request

    • owner: Propietario del repositorio (string, requerido)
    • repo: Nombre del repositorio (string, requerido)
    • pullNumber: Número del pull request (number, requerido)
  • create_pull_request_review - Crear una revisión en un pull request

  • owner: Propietario del repositorio (string, obligatorio)

    • repo: Nombre del repositorio (string, obligatorio)
    • pullNumber: Número de solicitud de extracción (number, obligatorio)
    • body: Texto del comentario de revisión (string, opcional)
    • event: Acción de revisión ('APPROVE', 'REQUEST_CHANGES', 'COMMENT') (string, obligatorio)
    • commitId: SHA del commit a revisar (string, opcional)
    • comments: Matriz de objetos de comentarios específicos de línea para colocar comentarios en los cambios de la solicitud de extracción (array, opcional)
      • Para comentarios en línea: proporcione path, position (o line) y body
      • Para comentarios de varias líneas: proporcione path, start_line, line, opcionalmente side/start_side y body
  • create_pull_request - Crear una nueva solicitud de extracción

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • title: Título de la solicitud de extracción (string, obligatorio)
    • body: Descripción de la solicitud de extracción (string, opcional)
    • head: Rama que contiene los cambios (string, obligatorio)
    • base: Rama en la que se fusionará (string, obligatorio)
    • draft: Crear como solicitud de extracción en borrador (boolean, opcional)
    • maintainer_can_modify: Permitir ediciones del mantenedor (boolean, opcional)
  • add_pull_request_review_comment - Agregar un comentario de revisión a una solicitud de extracción o responder a un comentario existente

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • pull_number: Número de solicitud de extracción (number, obligatorio)
    • body: El texto del comentario de revisión (string, obligatorio)
    • commit_id: El SHA del commit sobre el que se comenta (string, obligatorio a menos que se use in_reply_to)
    • path: La ruta relativa al archivo que requiere un comentario (string, obligatorio a menos que se use in_reply_to)
    • line: La línea del blob en el diff de la solicitud de extracción a la que se aplica el comentario (number, opcional)
    • side: El lado del diff sobre el que se comenta (LEFT o RIGHT) (string, opcional)
    • start_line: Para comentarios de varias líneas, la primera línea del rango (number, opcional)
    • start_side: Para comentarios de varias líneas, el lado inicial del diff (LEFT o RIGHT) (string, opcional)
    • subject_type: El nivel al que se dirige el comentario (line o file) (string, opcional)
    • in_reply_to: El ID del comentario de revisión al que se responde (number, opcional). Cuando se especifica, solo se requiere el cuerpo y los demás parámetros se ignoran.
  • update_pull_request - Actualizar una solicitud de extracción existente en un repositorio de GitHub

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • pullNumber: Número de solicitud de extracción a actualizar (number, obligatorio)
    • title: Nuevo título (string, opcional)
    • body: Nueva descripción (string, opcional)
    • state: Nuevo estado ('open' o 'closed') (string, opcional)
    • base: Nuevo nombre de rama base (string, opcional)
    • maintainer_can_modify: Permitir ediciones del mantenedor (boolean, opcional)
  • request_copilot_review - Solicitar una revisión de GitHub Copilot para una solicitud de extracción (experimental; sujeto al soporte de la API de GitHub)

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • pullNumber: Número de solicitud de extracción (number, obligatorio)
    • Nota: Actualmente, esta herramienta solo funcionará para github.com

Repositorios

  • create_or_update_file - Crear o actualizar un solo archivo en un repositorio

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • path: Ruta del archivo (string, obligatorio)
    • message: Mensaje del commit (string, obligatorio)
    • content: Contenido del archivo (string, obligatorio)
    • branch: Nombre de la rama (string, opcional)
    • sha: SHA del archivo si se actualiza (string, opcional)
  • list_branches - Listar ramas en un repositorio de GitHub

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • page: Número de página (number, opcional)
    • perPage: Resultados por página (number, opcional)
  • push_files - Enviar múltiples archivos en un solo commit

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • branch: Rama a la que enviar (string, obligatorio)
    • files: Archivos a enviar, cada uno con ruta y contenido (array, obligatorio)
    • message: Mensaje del commit (string, obligatorio)
  • search_repositories - Buscar repositorios de GitHub

    • query: Consulta de búsqueda (string, obligatorio)
    • sort: Campo de ordenación (string, opcional)
    • order: Orden de ordenación (string, opcional)
    • page: Número de página (number, opcional)
    • perPage: Resultados por página (number, opcional)
  • create_repository - Crear un nuevo repositorio de GitHub

    • name: Nombre del repositorio (string, obligatorio)
    • description: Descripción del repositorio (string, opcional)
    • private: Si el repositorio es privado (boolean, opcional)
    • autoInit: Auto-inicializar con README (boolean, opcional)
  • get_file_contents - Obtener el contenido de un archivo o directorio

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • path: Ruta del archivo (string, obligatorio)
    • ref: Referencia de Git (string, opcional)
  • fork_repository - Hacer un fork de un repositorio

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • organization: Nombre de la organización de destino (string, opcional)
  • create_branch - Crear una nueva rama

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • branch: Nombre de la nueva rama (string, obligatorio)
    • sha: SHA desde el cual crear la rama (string, obligatorio)
  • list_commits - Obtener una lista de commits de una rama en un repositorio

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • sha: Nombre de rama, etiqueta o SHA de commit (string, opcional)
    • path: Solo commits que contengan esta ruta de archivo (string, opcional)
    • page: Número de página (number, opcional)
    • perPage: Resultados por página (number, opcional)
  • get_commit - Obtener detalles de un commit de un repositorio

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • sha: SHA del commit, nombre de rama o nombre de etiqueta (string, obligatorio)
    • page: Número de página, para archivos en el commit (number, opcional)
    • perPage: Resultados por página, para archivos en el commit (number, opcional)
  • search_code - Buscar código en repositorios de GitHub

    • query: Consulta de búsqueda (string, obligatorio)
    • sort: Campo de ordenación (string, opcional)
    • order: Orden de ordenación (string, opcional)
    • page: Número de página (number, opcional)
    • perPage: Resultados por página (number, opcional)

Usuarios

  • search_users - Buscar usuarios de GitHub
    • q: Consulta de búsqueda (string, obligatorio)
    • sort: Campo de ordenación (string, opcional)
    • order: Orden de ordenación (string, opcional)
    • page: Número de página (number, opcional)
    • perPage: Resultados por página (number, opcional)

Escaneo de código

  • get_code_scanning_alert - Obtener una alerta de escaneo de código

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • alertNumber: Número de alerta (number, obligatorio)
  • list_code_scanning_alerts - Listar alertas de escaneo de código para un repositorio

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • ref: Referencia de Git (string, opcional)
    • state: Estado de la alerta (string, opcional)
    • severity: Severidad de la alerta (string, opcional)
    • tool_name: El nombre de la herramienta utilizada para el escaneo de código (string, opcional)

Escaneo de secretos

  • get_secret_scanning_alert - Obtener una alerta de escaneo de secretos

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • alertNumber: Número de alerta (number, obligatorio)
  • list_secret_scanning_alerts - Listar alertas de escaneo de secretos para un repositorio

    • owner: Propietario del repositorio (string, obligatorio)
    • repo: Nombre del repositorio (string, obligatorio)
    • state: Estado de la alerta (string, opcional)
    • secret_type: Los tipos de secretos a filtrar en una lista separada por comas (string, opcional)
    • resolution: El estado de resolución (string, opcional)

Notificaciones

  • list_notifications – Listar notificaciones para un usuario de GitHub

    • filter: Filtro a aplicar a la respuesta (default, include_read_notifications, only_participating)
    • since: Mostrar solo notificaciones actualizadas después de la hora dada (formato ISO 8601)
    • before: Mostrar solo notificaciones actualizadas antes de la hora dada (formato ISO 8601)
    • owner: Propietario del repositorio opcional (string)
    • repo: Nombre del repositorio opcional (string)
    • page: Número de página (number, opcional)
    • perPage: Resultados por página (number, opcional)
  • get_notification_details – Obtener información detallada para una notificación específica de GitHub

    • notificationID: El ID de la notificación (string, obligatorio)
  • dismiss_notification – Descartar una notificación marcándola como leída o hecha

    • threadID: El ID del hilo de notificación (string, obligatorio)
    • state: El nuevo estado de la notificación (read o done)
  • mark_all_notifications_read – Marcar todas las notificaciones como leídas

    • lastReadAt: Describe el último punto en que se revisaron las notificaciones (opcional, cadena RFC3339/ISO8601, predeterminado: ahora)
    • owner: Propietario del repositorio opcional (string)
    • repo: Nombre del repositorio opcional (string)
  • manage_notification_subscription – Gestionar una suscripción de notificación (ignorar, observar o eliminar) para un hilo de notificación

    • notificationID: El ID del hilo de notificación (string, obligatorio)
    • action: Acción a realizar: ignore, watch o delete (string, obligatorio)
  • manage_repository_notification_subscription – Gestionar una suscripción de notificación de repositorio (ignorar, observar o eliminar)

    • owner: El propietario de la cuenta del repositorio (string, obligatorio)
    • repo: El nombre del repositorio (string, obligatorio)
    • action: Acción a realizar: ignore, watch o delete (string, obligatorio)

Recursos

Contenido del repositorio

  • Obtener contenido del repositorio Recupera el contenido de un repositorio en una ruta específica.

    • Plantilla: repo://{owner}/{repo}/contents{/path*}
    • Parámetros:
      • owner: Propietario del repositorio (string, obligatorio)
      • repo: Nombre del repositorio (string, obligatorio)
      • path: Ruta de archivo o directorio (string, opcional)
  • Obtener contenido del repositorio para una rama específica Recupera el contenido de un repositorio en una ruta específica para una rama dada.

    • Plantilla: repo://{owner}/{repo}/refs/heads/{branch}/contents{/path*}
    • Parámetros:
      • owner: Propietario del repositorio (string, obligatorio)
      • repo: Nombre del repositorio (string, obligatorio)
      • branch: Nombre de la rama (string, obligatorio)
      • path: Ruta de archivo o directorio (string, opcional)
  • Obtener contenido del repositorio para un commit específico Recupera el contenido de un repositorio en una ruta específica para un commit dado.

    • Plantilla: repo://{owner}/{repo}/sha/{sha}/contents{/path*}
    • Parámetros:
      • owner: Propietario del repositorio (string, obligatorio)
      • repo: Nombre del repositorio (string, obligatorio)
      • sha: SHA del commit (string, obligatorio)
      • path: Ruta de archivo o directorio (string, opcional)
  • Obtener contenido del repositorio para una etiqueta específica Recupera el contenido de un repositorio en una ruta específica para una etiqueta dada.

    • Plantilla: repo://{owner}/{repo}/refs/tags/{tag}/contents{/path*}
    • Parámetros:
      • owner: Propietario del repositorio (string, obligatorio)
      • repo: Nombre del repositorio (string, obligatorio)
      • tag: Nombre de la etiqueta (string, obligatorio)
      • path: Ruta de archivo o directorio (string, opcional)
  • Obtener contenido del repositorio para una solicitud de extracción específica Recupera el contenido de un repositorio en una ruta específica para una solicitud de extracción dada.

    • Plantilla: repo://{owner}/{repo}/refs/pull/{prNumber}/head/contents{/path*}
    • Parámetros:
      • owner: Propietario del repositorio (string, obligatorio)
      • repo: Nombre del repositorio (string, obligatorio)
      • prNumber: Número de solicitud de extracción (string, obligatorio)
      • path: Ruta de archivo o directorio (string, opcional)

Uso de la biblioteca

La API de Go exportada de este módulo debe considerarse actualmente inestable y sujeta a cambios que puedan romper la compatibilidad. En el futuro, podríamos ofrecer estabilidad; por favor, abre un issue si hay un caso de uso donde esto sería valioso.

Licencia

Este proyecto está licenciado bajo los términos de la licencia de código abierto MIT. Consulte MIT para conocer los términos completos.