mcp-server-git: Un servidor MCP git

Descripción general

Un servidor de Protocolo de Contexto de Modelo para la interacción y automatización de repositorios Git. Este servidor proporciona herramientas para leer, buscar y manipular repositorios Git mediante Modelos de Lenguaje Grandes.

Tenga en cuenta que mcp-server-git se encuentra actualmente en desarrollo inicial. La funcionalidad y las herramientas disponibles están sujetas a cambios y ampliaciones a medida que continuamos desarrollando y mejorando el servidor.

Herramientas

1. git_status

   • Muestra el estado del árbol de trabajo.

   • Aporte:

     • repo_path (cadena): Ruta al repositorio de Git

   • Devuelve: Estado actual del directorio de trabajo como salida de texto

2. git_diff_unstaged

   • Muestra los cambios en el directorio de trabajo que aún no se han preparado

   • Aporte:

     • repo_path (cadena): Ruta al repositorio de Git

   • Devuelve: Salida diferencial de cambios no preparados

3. git_diff_staged

   • Muestra los cambios que están preparados para confirmarse

   • Aporte:

     • repo_path (cadena): Ruta al repositorio de Git

   • Devuelve: Salida diferencial de los cambios programados

4. git_diff

   • Muestra diferencias entre ramas o confirmaciones

   • Entradas:

     • repo_path (cadena): Ruta al repositorio de Git

     • target (cadena): rama de destino o confirmación con la que comparar

   • Devuelve: Salida diferencial que compara el estado actual con el objetivo

5. git_commit

   • Registra los cambios en el repositorio

   • Entradas:

     • repo_path (cadena): Ruta al repositorio de Git

     • message (cadena): Mensaje de confirmación

   • Devoluciones: Confirmación con nuevo hash de confirmación

6. git_add

   • Agrega contenido de archivo al área de preparación

   • Entradas:

     • repo_path (cadena): Ruta al repositorio de Git

     • files (cadena[]): Matriz de rutas de archivos a la etapa

   • Devoluciones: Confirmación de archivos preparados

7. git_reset

   • Desactiva todos los cambios programados

   • Aporte:

     • repo_path (cadena): Ruta al repositorio de Git

   • Devoluciones: Confirmación de la operación de reinicio

8. git_log

   • Muestra los registros de confirmación

   • Entradas:

     • repo_path (cadena): Ruta al repositorio de Git

     • max_count (número, opcional): Número máximo de confirmaciones a mostrar (predeterminado: 10)

   • Devuelve: Matriz de entradas de confirmación con hash, autor, fecha y mensaje

9. git_create_branch

   • Crea una nueva rama

   • Entradas:

     • repo_path (cadena): Ruta al repositorio de Git

     • branch_name (cadena): Nombre de la nueva rama

     • start_point (cadena, opcional): Punto de inicio para la nueva rama

   • Devoluciones: Confirmación de creación de rama

10. git_checkout

• Cambia de rama

• Entradas:

  • repo_path (cadena): Ruta al repositorio de Git

  • branch_name (cadena): Nombre de la sucursal a verificar

• Devoluciones: Confirmación de cambio de rama

11. git_show

• Muestra el contenido de una confirmación

• Entradas:

  • repo_path (cadena): Ruta al repositorio de Git

  • revision (cadena): La revisión (hash de confirmación, nombre de la rama, etiqueta) para mostrar

• Devuelve: Contenido de la confirmación especificada

12. git_init

• Inicializa un repositorio Git

• Entradas:

  • repo_path (cadena): Ruta al directorio para inicializar el repositorio git

• Devuelve: Confirmación de inicialización del repositorio

Related MCP server: GitLab MCP Server

Instalación

Uso de uv (recomendado)

Al usar uv no se requiere ninguna instalación específica. Usaremos uvx para ejecutar directamente mcp-server-git .

Uso de PIP

Alternativamente, puede instalar mcp-server-git a través de pip:

Después de la instalación, puedes ejecutarlo como un script usando:

Configuración

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

• Nota: reemplace '/Users/username' con la ruta a la que desea que esta herramienta pueda acceder

Uso con VS Code

Para una instalación rápida, utilice uno de los botones de instalación de un solo clic que aparecen a continuación...

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json .

Para la instalación de Docker:

Uso con Zed

Añade a tu configuración Zed settings.json:

Depuración

Puede usar el inspector MCP para depurar el servidor. Para instalaciones uvx:

O si ha instalado el paquete en un directorio específico o está desarrollando en él:

Ejecutar tail -n 20 -f ~/Library/Logs/Claude/mcp*.log mostrará los registros del servidor y puede ayudarlo a depurar cualquier problema.

Desarrollo

Si está realizando un desarrollo local, hay dos formas de probar sus cambios:

1. Ejecute el inspector de MCP para probar los cambios. Consulte Depuración para obtener instrucciones de ejecución.

2. Prueba con la aplicación de escritorio Claude. Agrega lo siguiente a tu claude_desktop_config.json :

Estibador

UVX

Construir

Compilación de Docker:

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.