Servidor MCP de GitHub Enterprise

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

Guía de instalación de Cline

Esta guía le ayudará a instalar y configurar el servidor MCP de GitHub Enterprise en Cline, lo que le permitirá utilizar la funcionalidad de la API de GitHub directamente a través de Cline.

Prerrequisitos

Node.js instalado en su sistema
Un token de acceso personal de GitHub con los permisos adecuados
Cline instalado en su sistema

Pasos de instalación

1. Clonar el repositorio

git clone https://github.com/yourusername/github-enterprise-mcp.git
cd github-enterprise-mcp

2. Instalar dependencias y compilar

npm install
npm run build

Esto creará un directorio dist con los archivos JavaScript compilados.

3. Crea un token de acceso personal de GitHub

Vaya a Tokens de acceso personal de GitHub (en Configuración de GitHub > Configuración de desarrollador)
Haga clic en "Generar nuevo token"
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

4. Configurar los ajustes de Cline MCP

Para la extensión Cline VS Code

Abrir VS Code
Localice el archivo de configuración de Cline MCP en:
- Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
- macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Agregue la configuración del servidor MCP de GitHub Enterprise al objeto mcpServers :

{
  "mcpServers": {
    "github-enterprise": {
      "command": "node",
      "args": [
        "/absolute/path/to/github-enterprise-mcp/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-personal-access-token",
        "GITHUB_API_URL": "https://api.github.com" // For GitHub.com
        // For GitHub Enterprise, use your instance URL, e.g., "https://github.yourdomain.com/api/v3"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Reemplace /absolute/path/to/github-enterprise-mcp/dist/index.js con la ruta absoluta al archivo index.js creado.

Para la aplicación de escritorio de Claude

Localice el archivo de configuración de Claude Desktop en:
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Agregue la configuración del servidor MCP de GitHub Enterprise al objeto mcpServers :

{
  "mcpServers": {
    "github-enterprise": {
      "command": "node",
      "args": [
        "/absolute/path/to/github-enterprise-mcp/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-personal-access-token",
        "GITHUB_API_URL": "https://api.github.com" // For GitHub.com
        // For GitHub Enterprise, use your instance URL, e.g., "https://github.yourdomain.com/api/v3"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

5. Reiniciar Cline

Después de configurar los ajustes de MCP, reinicie Cline (VS Code o Claude Desktop) para aplicar los cambios.

Verificación

Para verificar que el servidor MCP de GitHub Enterprise esté correctamente instalado y configurado, puedes pedirle a Cline que use una de las herramientas de GitHub:

Can you search for repositories with the keyword "react" using the GitHub Enterprise MCP server?

Cline debería poder usar la herramienta search_repositories para buscar repositorios con la palabra clave "react".

Instalación interactiva con Cline

Para una experiencia de instalación interactiva, copie y pegue el siguiente texto en Cline y lo guiará a través del proceso de instalación:

I want you to help me install the GitHub Enterprise MCP server. Here's what I need you to do:

1. First, explain what the GitHub Enterprise MCP server is and what capabilities it will give you.

2. Guide me through the installation process:
   - Help me clone the repository (if I haven't already)
   - Help me install dependencies and build the project
   - Guide me through creating a GitHub Personal Access Token if I don't have one
   - Help me configure the MCP settings in either VS Code or Claude Desktop
   - Verify the installation is working

3. Show me some examples of how I can use the GitHub Enterprise MCP server once it's installed.

Please start by explaining what the GitHub Enterprise MCP server is and what it will allow you to do for me.

Ejemplo de uso

Después de la instalación, puedes pedirle a Cline que realice operaciones de GitHub directamente, como:

"Crear un nuevo repositorio llamado 'mi-proyecto'"
Búsqueda de repositorios relacionados con el aprendizaje automático
"Crear una solicitud de extracción desde mi rama de funciones a la rama principal"
"Obtener el contenido del archivo README.md en el repositorio X"
"Enumerar problemas abiertos en mi repositorio"

Solución de problemas

Si encuentra problemas con el servidor MCP de GitHub Enterprise:

Comprueba que la ruta al archivo index.js sea correcta en la configuración de tu MCP
Verifique que su token de acceso personal de GitHub tenga los permisos necesarios
Asegúrese de que la URL de la API de GitHub sea correcta para su instancia de GitHub
Revise los registros para ver si hay mensajes de error

Opciones de configuración adicionales

Versión de la API de GitHub

Puede especificar una versión de API de GitHub agregando la variable de entorno GITHUB_API_VERSION :

"env": {
  "GITHUB_PERSONAL_ACCESS_TOKEN": "your-personal-access-token",
  "GITHUB_API_URL": "https://api.github.com",
  "GITHUB_API_VERSION": "2022-11-28"
}

Autenticación empresarial

Para las instancias de GitHub Enterprise que utilizan diferentes métodos de autenticación, es posible que deba proporcionar una configuración adicional. Consulte la documentación de Octokit para obtener más información.

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

Añadir 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

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 :

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "/path/to/github-enterprise-mcp/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Construir

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

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.

GitHub Enterprise MCP Server

Integrations