remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to GitHub repository contents, allowing browsing and reading files from specified repositories, navigating directories, and supporting branch-specific file access.

Servidor de repositorio GitHub de MCP

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona acceso al contenido del repositorio de GitHub. Este servidor permite a los asistentes de IA explorar y leer archivos de repositorios de GitHub específicos.

Manifestación

Características

Recursos

Acceda a cualquier archivo en un repositorio de GitHub a través de URI
Listar el contenido del repositorio y navegar por los directorios
Soporte para acceso a archivos específicos de la rama
El contenido del archivo se sirve como texto sin formato.

URI de recursos

Formato de URL base: https://api.github.com/repos/{owner}/{repo}/contents/{path}
Admite tanto archivos como directorios
Los archivos se sirven con tipo MIME text/plain
Los directorios se sirven con el tipo MIME application/x-directory

Configuración

El servidor requiere las siguientes variables de entorno:

GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token
GITHUB_OWNER=repository_owner
GITHUB_REPO=repository_name
GITHUB_BRANCH=branch_name  # Optional

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para utilizar con Claude Desktop, agregue la configuración del servidor:

Ubicación de configuración

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-github-repo": {
      "command": "/path/to/mcp-server-github-repo/build/index.js"
    }
  }
}

Implementación de API

El servidor implementa tres puntos finales MCP principales:

ListResources : enumera archivos y directorios en el repositorio
ReadResource : recupera el contenido de un archivo específico

Autenticación

El servidor utiliza el token de acceso personal de GitHub para la autenticación. Asegúrate de que tu token tenga los permisos adecuados para acceder al contenido del repositorio.

Manejo de errores

El servidor incluye gestión de errores para:

Variables de entorno faltantes
Errores de la API de GitHub
Rutas no válidas (por ejemplo, intentar leer un directorio como un archivo)
Errores de autenticación

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Utilice el Inspector MCP para depurar:

npm run inspector

Esto proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Notas de seguridad

Mantenga seguro su token de acceso personal de GitHub
Considere usar tokens con permisos mínimos requeridos
Tenga en cuenta las limitaciones de tamaño del repositorio al acceder a repositorios grandes

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor que permite a los asistentes de IA explorar y leer archivos de repositorios de GitHub específicos, proporcionando acceso al contenido del repositorio a través del Protocolo de contexto de modelo.

Related Resources

Reddit Discussion about this server

MCP GitHub Repository Server