MCP Git Repo Browser

Un servidor para navegar e interactuar con repositorios Git locales.

GitHub
5

Documentación

MCP Git Repo Browser (Node.js)

Una implementación en Node.js de un navegador de repositorios Git utilizando el Protocolo de Contexto de Modelos (MCP).

Git Repo Browser MCP server

Configuración

Agrega esto a tu archivo de configuración de ajustes de MCP:

{
    "mcpServers": {
        "mcp-git-repo-browser": {
            "command": "node",
            "args": ["/path/to/mcp-git-repo-browser/src/index.js"]
        }
    }
}

Características

El servidor proporciona dos herramientas principales:

  1. git_directory_structure: Devuelve una representación tipo árbol de la estructura de directorios de un repositorio

    • Entrada: URL del repositorio
    • Salida: Representación en árbol ASCII de la estructura del repositorio

  2. git_read_important_files: Lee y devuelve el contenido de archivos específicos en un repositorio

    • Entrada: URL del repositorio y lista de rutas de archivos
    • Salida: Diccionario que mapea rutas de archivos a sus contenidos

Detalles de Implementación

  • Utiliza módulos nativos de Node.js (crypto, path, os) para la funcionalidad principal
  • Aprovecha fs-extra para operaciones de archivos mejoradas
  • Utiliza simple-git para operaciones de repositorios Git
  • Implementa manejo limpio de errores y limpieza de recursos
  • Crea directorios temporales deterministas basados en hashes de URLs de repositorios
  • Reutiliza repositorios clonados cuando es posible para mayor eficiencia

Requisitos

  • Node.js 14.x o superior
  • Git instalado en el sistema

Instalación

git clone <repository-url>
cd mcp-git-repo-browser
npm install

Uso

Inicia el servidor:

node src/index.js

El servidor se ejecuta en stdio, lo que lo hace compatible con clientes MCP.

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.