Git MCP

Name: Git MCP
Author: kjozsa

insignia de herrería Servidor MCP para administrar operaciones de Git en repositorios locales.

Instalación

Instalación mediante herrería

Para instalar Git MCP para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @kjozsa/git-mcp --client claude

Instalación manual

uvx install git-mcp

Related MCP server: GitHub MCP Server Plus

Configuración

Agregue el servidor MCP utilizando el siguiente fragmento de configuración JSON:

{ "mcpServers": { "git-mcp": { "command": "uvx", "args": ["git-mcp"], "env": { "GIT_REPOS_PATH": "/path/to/your/git/repositories" } } } }

Características y uso

Variables de entorno

GIT_REPOS_PATH : Ruta al directorio que contiene sus repositorios Git (obligatorio)

Puede configurar esto en su entorno o crear un archivo .env en el directorio donde ejecuta el servidor.

Métodos disponibles

lista_de_repositorios

Enumera todos los repositorios Git en la ruta configurada.

Parámetros: Ninguno
Devuelve: Lista de nombres de repositorios

obtener_última_etiqueta_git

Encuentra la última etiqueta Git en el repositorio especificado.

Parámetros: repo_name (nombre del repositorio Git)
Devuelve: Diccionario con version (nombre de la etiqueta) y date (fecha de creación de la etiqueta)

lista_de_confirmaciones_desde_la_última_etiqueta

Enumera los mensajes de confirmación entre la última etiqueta Git y HEAD.

Parámetros:
- repo_name : Nombre del repositorio Git
- max_count (opcional): Número máximo de confirmaciones a devolver
Devuelve: Lista de diccionarios con hash , author , date y message

crear_etiqueta_git

Crea una nueva etiqueta git en el repositorio especificado.

Parámetros:
- repo_name : Nombre del repositorio git
- tag_name : Nombre de la etiqueta a crear
- message (opcional): Mensaje para la etiqueta anotada (si no se proporciona, crea una etiqueta liviana)
Devuelve: Diccionario con status , version (nombre de la etiqueta), date (fecha de creación de la etiqueta) y type (anotado o ligero)

etiqueta_de_git_push

Envía una etiqueta git existente al repositorio remoto predeterminado.

Parámetros:
- repo_name : Nombre del repositorio git
- tag_name : Nombre de la etiqueta a enviar
Devuelve: Diccionario con status , remote (nombre del control remoto), tag (nombre de la etiqueta) y message (mensaje de éxito)

actualizar_repositorio

Actualiza un repositorio extrayendo la rama principal (o master como respaldo) y extrayendo desde todos los remotos.

Parámetros:
- repo_name : Nombre del repositorio git
Devuelve: Diccionario con status , repository , branch y pull_results (resultados para cada control remoto)

Solución de problemas

Repositorio no encontrado : asegúrese de que GIT_REPOS_PATH esté configurado correctamente y que el repositorio exista
No se encontraron etiquetas : el repositorio aún no tiene etiquetas

Desarrollo

# Install dependencies uv pip install -r requirements.txt # Run in dev mode with Inspector mcp dev git_mcp/server.py

Pruebas

El proyecto incluye dos scripts de prueba:

test_git_mcp.py : prueba la funcionalidad del comando Git subyacente directamente, sin utilizar el servidor MCP.
test_mcp_server.py : prueba la funcionalidad del servidor MCP iniciando una instancia de servidor y realizándole llamadas.

Para ejecutar las pruebas:

# Test the Git command functionality python test_git_mcp.py # Test the MCP server (requires the git-mcp package to be installed) python test_mcp_server.py