Servidor MCP del repositorio de GitHub

Este servidor de Protocolo de Contexto de Modelo (MCP) permite a los modelos de IA acceder al contenido del repositorio de GitHub como contexto. Proporciona herramientas para recuperar el contenido de los archivos, la estructura del repositorio y repositorios completos para usarlos como contexto en las interacciones de IA.

Características

• Obtener todo el contenido del repositorio como contexto

• Obtener contenidos de archivos específicos de un repositorio

• Obtener la estructura del repositorio (listado de archivos)

• Filtrar archivos por extensión

• Excluir rutas específicas

• Limitar el número de archivos devueltos

Related MCP server: GitHub MCP Server

Instalación

Uso

Configuración de la autenticación de GitHub

Aunque el servidor puede trabajar con repositorios públicos sin autenticación, la API de GitHub tiene límites estrictos de velocidad para solicitudes no autenticadas (60 solicitudes/hora). Para aumentar este límite a 5000 solicitudes/hora, configure la variable de entorno GITHUB_TOKEN :

Puedes crear un token de acceso personal en tu Configuración de desarrollador de GitHub .

Uso con cursor

Para utilizar este servidor con Cursor siga estos pasos:

1. Abrir configuración del cursor

2. Buscar "MCP"

3. Haga clic en "Agregar un nuevo servidor MCP"

4. Introduzca la siguiente información:

   • Nombre: github-repo-context (o cualquier nombre que desee)

   • Tipo: Comando

   • Comando: /ruta/a/la-configuración-de-su-repositorio-local/gh.sh

5. Haga clic en "Guardar"

6. Habilite el servidor haciendo clic en el interruptor junto al nombre del servidor

7. Ahora deberías poder usar el servidor en tu proyecto.

El servidor se comunica a través de stdin/stdout siguiendo el protocolo MCP.

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

1. get-repo-context : obtiene todos los archivos de un repositorio de GitHub para usarlos como contexto

   • Parámetros:

     • owner : nombre del propietario/organización del repositorio de GitHub

     • repo : nombre del repositorio de GitHub

     • maxFiles (opcional): Número máximo de archivos a incluir (predeterminado: 50)

     • fileExtensions (opcional): extensiones de archivo a incluir (por ejemplo, ['js', 'ts', 'md'])

     • excludePaths (opcional): rutas para excluir (predeterminado: ['node_modules', 'dist', 'build'])

2. get-file-content : obtener el contenido de un archivo específico de un repositorio de GitHub

   • Parámetros:

     • owner : nombre del propietario/organización del repositorio de GitHub

     • repo : nombre del repositorio de GitHub

     • path : Ruta al archivo en el repositorio

3. get-repo-structure : obtener la estructura de un repositorio de GitHub

   • Parámetros:

     • owner : nombre del propietario/organización del repositorio de GitHub

     • repo : nombre del repositorio de GitHub

Ejemplo

Cuando se integra con un modelo de IA compatible con MCP, puede usar comandos como:

Luego, la IA utilizaría la herramienta get-repo-structure para obtener y mostrar la estructura del repositorio.