Navegador de repositorios Git de MCP (Node.js)
Una implementación de Node.js de un navegador de repositorio Git utilizando el Protocolo de Contexto de Modelo (MCP).
Instalación
NPM (Recomendado)
npm install -g git-commands-mcp
Instalación manual
git clone https://github.com/bsreeram08/git-commands-mcp.git
cd git-commands-mcp
npm install
Configuración
Agregue esto a su archivo de configuración de MCP:
{
"mcpServers": {
"git-commands-mcp": {
"command": "git-commands-mcp"
}
}
}
Para la instalación manual, utilice:
{
"mcpServers": {
"git-commands-mcp": {
"command": "node",
"args": ["/path/to/git-commands-mcp/src/index.js"]
}
}
}
Características
El servidor proporciona las siguientes herramientas:
Operaciones básicas del repositorio
git_directory_structure : Devuelve una representación en forma de árbol de la estructura de directorios de un repositorio- Entrada: URL del repositorio
- Salida: Representación en árbol ASCII de la estructura del repositorio
git_read_files : lee y devuelve el contenido de los archivos especificados en un repositorio- Entrada: URL del repositorio y lista de rutas de archivos
- Salida: Diccionario que asigna rutas de archivos a sus contenidos
git_search_code : busca patrones en el código del repositorio- Entrada: URL del repositorio, patrón de búsqueda, patrones de archivo opcionales, distinción entre mayúsculas y minúsculas y líneas de contexto
- Salida: JSON con resultados de búsqueda que incluyen líneas coincidentes y contexto
Operaciones de sucursal
git_branch_diff : Compara dos ramas y muestra los archivos modificados entre ellas- Entrada: URL del repositorio, rama de origen, rama de destino y bandera show_patch opcional
- Salida: JSON con recuento de confirmaciones y resumen de diferencias
Operaciones de confirmación
git_commit_history : obtiene el historial de confirmaciones de una rama con filtrado opcional- Entrada: URL del repositorio, nombre de la rama, recuento máximo, filtro de autor, fecha de inicio, fecha de finalización y mensaje grep
- Salida: JSON con detalles de confirmación
git_commits_details : Obtenga información detallada sobre las confirmaciones, incluidos mensajes completos y diferencias- Entrada: URL del repositorio, nombre de la rama, recuento máximo, indicador include_diff, filtro de autor, fecha de inicio, fecha de finalización y mensaje grep
- Salida: JSON con información detallada de confirmación
git_local_changes : Obtener cambios no confirmados en el directorio de trabajo- Entrada: Ruta del repositorio local
- Salida: JSON con información de estado y diferencias
Estructura del proyecto
git-commands-mcp/
├── src/
│ ├── index.js # Entry point
│ ├── server.js # Main server implementation
│ ├── handlers/ # Tool handlers
│ │ └── index.js # Tool implementation functions
│ └── utils/ # Utility functions
│ └── git.js # Git-related helper functions
├── package.json
└── readme.md
Detalles de implementación
- Utiliza módulos nativos de Node.js (crypto, path, os) para la funcionalidad principal
- Aprovecha fs-extra para mejorar las operaciones con archivos
- Utiliza simple-git para operaciones del repositorio Git
- Implementa un manejo limpio de errores y limpieza de recursos.
- Crea directorios temporales deterministas basados en hashes de URL del repositorio
- Reutiliza repositorios clonados cuando sea posible para mayor eficiencia
- Estructura de código modular para una mejor mantenibilidad
Requisitos
- Node.js 14.x o superior
- Git instalado en el sistema
Uso
Si se instala globalmente a través de npm:
Si se instala manualmente:
El servidor se ejecuta en stdio, lo que lo hace compatible con los clientes MCP.
CI/CD
Este proyecto utiliza GitHub Actions para la integración y la implementación continuas:
Publicación automática de NPM
El repositorio está configurado con un flujo de trabajo de GitHub Actions que publica automáticamente el paquete en npm cuando se envían cambios a la rama maestra.
Configuración de NPM_AUTOMATION_TOKEN
Para habilitar la publicación automática, debes agregar un token de automatización npm como un secreto de GitHub (esto funciona incluso con cuentas que tienen 2FA habilitado):
- Generar un token de automatización npm:
- Inicie sesión en su cuenta npm en npmjs.com
- Ve a la configuración de tu perfil
- Seleccione "Tokens de acceso"
- Haga clic en "Generar nuevo token"
- Seleccione el tipo de token "Automatización"
- Establezca los permisos adecuados (se requiere "Leer y escribir" para los paquetes)
- Copiar el token generado
- Añade el token a tu repositorio de GitHub:
- Vaya a su repositorio de GitHub
- Vaya a "Configuración" > "Secretos y variables" > "Acciones".
- Haga clic en "Nuevo secreto del repositorio".
- Nombre:
NPM_AUTOMATION_TOKEN - Valor: Pegue su token de automatización npm
- Haga clic en "Agregar secreto"
Una vez configurado, cualquier envío a la rama maestra activará el flujo de trabajo para publicar el paquete en npm.
Licencia
Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.
Campo de golf