Servidor MCP de GitHub

Servidor MCP para la API de GitHub, que permite operaciones de archivos, gestión de repositorios, funcionalidad de búsqueda y más.

Características

Creación automática de ramas : al crear o actualizar archivos o enviar cambios, las ramas se crean automáticamente si no existen.
Manejo integral de errores : mensajes de error claros para problemas comunes
Preservación del historial de Git : las operaciones mantienen el historial de Git adecuado sin forzar el envío.
Operaciones por lotes : compatibilidad con operaciones de un solo archivo y de varios archivos
Búsqueda avanzada : Soporte para búsqueda de código, problemas/PR y usuarios

Herramientas

create_or_update_file
- Crear o actualizar un solo archivo en un repositorio
- Entradas:
  - owner (cadena): propietario del repositorio (nombre de usuario u organización)
  - repo (cadena): nombre del repositorio
  - path (cadena): Ruta donde crear/actualizar el archivo
  - content (cadena): Contenido del archivo
  - message (cadena): Mensaje de confirmación
  - branch (cadena): Rama para crear/actualizar el archivo en
  - sha (cadena opcional): SHA del archivo que se va a reemplazar (para actualizaciones)
- Devuelve: Contenido del archivo y detalles de confirmación
push_files
- Insertar varios archivos en una sola confirmación
- Entradas:
  - owner (cadena): Propietario del repositorio
  - repo (cadena): nombre del repositorio
  - branch (cadena): Rama a la que enviar
  - files (matriz): archivos para enviar, cada uno con path y content
  - message (cadena): Mensaje de confirmación
- Devoluciones: Referencia de rama actualizada
search_repositories
- Buscar repositorios de GitHub
- Entradas:
  - query (cadena): consulta de búsqueda
  - page (número opcional): Número de página para paginación
  - perPage (número opcional): Resultados por página (máximo 100)
- Devuelve: Resultados de la búsqueda del repositorio
create_repository
- Crear un nuevo repositorio de GitHub
- Entradas:
  - name (cadena): nombre del repositorio
  - description (cadena opcional): Descripción del repositorio
  - private (booleano opcional): si el repositorio debe ser privado
  - autoInit (booleano opcional): inicializar con README
- Devoluciones: Detalles del repositorio creado
get_file_contents
- Obtener el contenido de un archivo o directorio
- Entradas:
  - owner (cadena): Propietario del repositorio
  - repo (cadena): nombre del repositorio
  - path (cadena): Ruta al archivo/directorio
  - branch (cadena opcional): rama de la que obtener el contenido
- Devuelve: Contenido del archivo/directorio
create_issue
- Crear un nuevo problema
- Entradas:
  - owner (cadena): Propietario del repositorio
  - repo (cadena): nombre del repositorio
  - title (cadena): Título del problema
  - body (cadena opcional): Descripción del problema
  - assignees (cadena opcional[]): nombres de usuario para asignar
  - labels (cadena opcional[]): etiquetas para agregar
  - milestone (número opcional): Número de hito
- Devoluciones: Detalles del problema creado
create_pull_request
- Crear una nueva solicitud de extracción
- Entradas:
  - owner (cadena): Propietario del repositorio
  - repo (cadena): nombre del repositorio
  - title (cadena): título de PR
  - body (cadena opcional): descripción de PR
  - head (cadena): rama que contiene los cambios
  - base (cadena): rama en la que fusionarse
  - draft (booleano opcional): Crear como borrador de PR
  - maintainer_can_modify (booleano opcional): Permitir ediciones del mantenedor
- Devoluciones: Detalles de la solicitud de extracción creada
fork_repository
- Bifurcar un repositorio
- Entradas:
  - owner (cadena): Propietario del repositorio
  - repo (cadena): nombre del repositorio
  - organization (cadena opcional): Organización a la que se bifurcará
- Devoluciones: Detalles del repositorio bifurcado
create_branch
- Crear una nueva rama
- Entradas:
  - owner (cadena): Propietario del repositorio
  - repo (cadena): nombre del repositorio
  - branch (cadena): Nombre de la nueva rama
  - from_branch (cadena opcional): rama de origen (predeterminada al valor predeterminado del repositorio)
- Devuelve: Referencia de rama creada
list_issues

Enumerar y filtrar problemas del repositorio
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- state (cadena opcional): filtrar por estado ('abierto', 'cerrado', 'todos')
- labels (cadena opcional[]): Filtrar por etiquetas
- sort (cadena opcional): Ordenar por ('creado', 'actualizado', 'comentarios')
- direction (cadena opcional): Ordenar dirección ('asc', 'desc')
- since (cadena opcional): Filtrar por fecha (marca de tiempo ISO 8601)
- page (número opcional): Número de página
- per_page (número opcional): Resultados por página
Devoluciones: Matriz de detalles del problema

update_issue

Actualizar un problema existente
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- issue_number (número): Número de problema a actualizar
- title (cadena opcional): Nuevo título
- body (cadena opcional): Nueva descripción
- state (cadena opcional): Nuevo estado ('abierto' o 'cerrado')
- labels (cadena opcional[]): Nuevas etiquetas
- assignees (cadena opcional[]): nuevos cesionarios
- milestone (número opcional): Nuevo número de hito
Devoluciones: Detalles del problema actualizados

add_issue_comment

Agregar un comentario a un problema
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- issue_number (número): Número de problema sobre el que se realizará el comentario
- body (cadena): Texto del comentario
Devoluciones: Detalles del comentario creado

search_code

Buscar código en los repositorios de GitHub
Entradas:
- q (cadena): consulta de búsqueda utilizando la sintaxis de búsqueda de código de GitHub
- sort (cadena opcional): campo de ordenación (solo 'indexado')
- order (cadena opcional): orden de clasificación ('asc' o 'desc')
- per_page (número opcional): Resultados por página (máximo 100)
- page (número opcional): Número de página
Devuelve: Resultados de búsqueda de código con contexto de repositorio

search_issues

Buscar problemas y solicitudes de extracción
Entradas:
- q (cadena): consulta de búsqueda que utiliza la sintaxis de búsqueda de problemas de GitHub
- sort (cadena opcional): campo de ordenación (comentarios, reacciones, creados, etc.)
- order (cadena opcional): orden de clasificación ('asc' o 'desc')
- per_page (número opcional): Resultados por página (máximo 100)
- page (número opcional): Número de página
Devoluciones: Resultados de búsqueda de problemas y solicitudes de extracción

search_users

Buscar usuarios de GitHub
Entradas:
- q (cadena): consulta de búsqueda que utiliza la sintaxis de búsqueda de usuarios de GitHub
- sort (cadena opcional): campo de ordenación (seguidores, repositorios, unidos)
- order (cadena opcional): orden de clasificación ('asc' o 'desc')
- per_page (número opcional): Resultados por página (máximo 100)
- page (número opcional): Número de página
Devuelve: Resultados de búsqueda del usuario

list_commits

Obtiene confirmaciones de una rama en un repositorio
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- page (cadena opcional): número de página
- per_page (cadena opcional): número de registros por página
- sha (cadena opcional): nombre de la rama
Devuelve: Lista de confirmaciones

get_issue

Obtiene el contenido de un problema dentro de un repositorio
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- issue_number (número): Número de problema a recuperar
Devoluciones: objeto de problema de Github y detalles

get_pull_request

Obtener detalles de una solicitud de extracción específica
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- pull_number (número): número de solicitud de extracción
Devoluciones: Detalles de la solicitud de extracción, incluyendo la diferencia y el estado de la revisión

list_pull_requests

Listar y filtrar solicitudes de extracción del repositorio
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- state (cadena opcional): filtrar por estado ('abierto', 'cerrado', 'todos')
- head (cadena opcional): filtrar por usuario/organización principal y rama
- base (cadena opcional): Filtrar por rama base
- sort (cadena opcional): Ordenar por ('creado', 'actualizado', 'popularidad', 'de larga duración')
- direction (cadena opcional): Ordenar dirección ('asc', 'desc')
- per_page (número opcional): Resultados por página (máximo 100)
- page (número opcional): Número de página
Devoluciones: Matriz de detalles de la solicitud de extracción

create_pull_request_review

Crear una revisión en una solicitud de extracción
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- pull_number (número): número de solicitud de extracción
- body (cadena): Texto del comentario de la revisión
- event (cadena): Acción de revisión ('APROBAR', 'SOLICITAR_CAMBIOS', 'COMENTARIO')
- commit_id (cadena opcional): SHA de la confirmación a revisar
- comments (matriz opcional): comentarios específicos de cada línea, cada uno con:
  - path (cadena): Ruta del archivo
  - position (número): Posición de línea en diff
  - body (cadena): Texto del comentario
Devoluciones: Detalles de la revisión creada

merge_pull_request

Fusionar una solicitud de extracción
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- pull_number (número): número de solicitud de extracción
- commit_title (cadena opcional): Título para la confirmación de fusión
- commit_message (cadena opcional): detalle adicional para la confirmación de fusión
- merge_method (cadena opcional): método de fusión ('merge', 'squash', 'rebase')
Devoluciones: Combinar detalles de resultados

get_pull_request_files

Obtener la lista de archivos modificados en una solicitud de extracción
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- pull_number (número): número de solicitud de extracción
Devoluciones: Matriz de archivos modificados con detalles del parche y el estado

get_pull_request_status

Obtener el estado combinado de todas las comprobaciones de estado para una solicitud de extracción
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- pull_number (número): número de solicitud de extracción
Devoluciones: Resultados de verificación de estado combinados y detalles de verificación individuales

update_pull_request_branch

Actualizar una rama de solicitud de extracción con los últimos cambios de la rama base (equivalente al botón "Actualizar rama" de GitHub)
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- pull_number (número): número de solicitud de extracción
- expected_head_sha (cadena opcional): El SHA esperado de la referencia HEAD de la solicitud de extracción
Devuelve: Mensaje de éxito cuando se actualiza la rama

get_pull_request_comments

Obtener los comentarios de revisión en una solicitud de extracción
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- pull_number (número): número de solicitud de extracción
Devoluciones: Matriz de comentarios de revisión de solicitudes de extracción con detalles como el texto del comentario, el autor y la ubicación en la diferencia.

get_pull_request_reviews

Obtenga las revisiones en una solicitud de extracción
Entradas:
- owner (cadena): Propietario del repositorio
- repo (cadena): nombre del repositorio
- pull_number (número): número de solicitud de extracción
Devoluciones: Matriz de revisiones de solicitudes de extracción con detalles como el estado de la revisión (APROBADO, CAMBIOS SOLICITADOS, etc.), el revisor y el cuerpo de la revisión

Related MCP server: MCP Development Framework

Sintaxis de consulta de búsqueda

Búsqueda de código

language:javascript : Buscar por lenguaje de programación
repo:owner/name : Buscar en un repositorio específico
path:app/src : Buscar en una ruta específica
extension:js : Buscar por extensión de archivo
Ejemplo: q: "import express" language:typescript path:src/

Búsqueda de problemas

is:issue o is:pr : Filtrar por tipo
is:open o is:closed : Filtrar por estado
label:bug : Buscar por etiqueta
author:username : Buscar por autor
Ejemplo: q: "memory leak" is:issue is:open label:bug

Búsqueda de usuarios

type:user o type:org : Filtrar por tipo de cuenta
followers:>1000 : Filtrar por seguidores
location:London : Buscar por ubicación
Ejemplo: q: "fullstack developer" location:London followers:>100

Para conocer la sintaxis de búsqueda detallada, consulte la documentación de búsqueda de GitHub .

Configuración

Token de acceso personal

Cree un token de acceso personal de GitHub con los permisos adecuados:

Vaya a Tokens de acceso personal (en Configuración de GitHub > Configuración de desarrollador)
Seleccione los repositorios a los que desea que este token tenga acceso (Público, Todos o Seleccionar)
Crea un token con el alcance repo ("Control total de repositorios privados")
- Alternativamente, si trabaja solo con repositorios públicos, seleccione solo el ámbito public_repo
Copiar el token generado

Uso con Claude Desktop

Para usar esto con Claude Desktop, agregue lo siguiente a su claude_desktop_config.json :

Estibador

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

NPX

{ "mcpServers": { "github": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" } } } }

Construir

Compilación de Docker:

docker build -t mcp/github -f src/github/Dockerfile .

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

Zerops Documentation MCP Server