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

Instalación

# clone the repository
git clone https://github.com/shanksxz/github-mcp.git
cd github-mcp

# install dependencies
npm install

# build the project
npm run build

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 :

# create a file called gh.sh and add the following line:
export GITHUB_TOKEN=your_github_personal_access_token
# make the file executable
chmod +x gh.sh
# run the file
./gh.sh

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:

Abrir configuración del cursor
Buscar "MCP"
Haga clic en "Agregar un nuevo servidor MCP"
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
Haga clic en "Guardar"
Habilite el servidor haciendo clic en el interruptor junto al nombre del servidor
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:

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'])
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
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:

Get the structure of the repository tensorflow/tensorflow

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

GitHub Repository MCP Server

Integrations