Servidor Git MCP

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona herramientas para interactuar con repositorios Git. Permite a los LLM y agentes de IA realizar operaciones Git como clonar, confirmar, enviar, extraer, ramificar, comparar, registrar, establecer estado y más mediante el estándar MCP.

Construido sobre la cyanheads/mcp-ts-template , este servidor sigue una arquitectura modular:

Nota para el desarrollador : este repositorio incluye un archivo .clinerules que sirve como hoja de trucos para desarrolladores para su agente de codificación LLM con referencia rápida para los patrones de base de código, ubicaciones de archivos y fragmentos de código.

Tabla de contenido

| Descripción general | Características | Instalación |

| Configuración | Estructura del proyecto |

| Herramientas | Recursos | Desarrollo | Licencia |

Descripción general

¡Potencie a sus agentes de IA y herramientas de desarrollo con una integración perfecta de Git!

El servidor Git MCP actúa como un puente que permite que las aplicaciones (clientes MCP) que entienden el Protocolo de contexto de modelo (MCP), como los asistentes de IA avanzados (LLM), las extensiones IDE o los scripts personalizados, interactúen de forma directa y segura con los repositorios Git locales.

En lugar de scripts complejos o CLI manual, sus herramientas pueden aprovechar este servidor para:

• Automatice los flujos de trabajo de Git : clone repositorios, cree ramas, prepare cambios, confirme trabajos, envíe actualizaciones y administre etiquetas mediante programación.

• Obtenga información sobre el repositorio : verifique el estado, vea registros, compare cambios e inspeccione objetos Git sin salir de la aplicación host.

• Integre Git en el desarrollo impulsado por IA : permita que los LLM administren el control de versiones como parte de sus tareas de codificación o refactorización.

Basado en la robusta mcp-ts-template , este servidor proporciona una forma estandarizada, segura y eficiente de exponer la funcionalidad de Git mediante el estándar MCP. Esto se logra mediante la ejecución segura de la herramienta de línea de comandos git estándar instalada en el sistema mediante el módulo child_process de Node.js, lo que garantiza la compatibilidad y aprovecha al máximo la potencia de Git.

Características

Utilidades principales (desde plantilla)

Aprovecha las robustas utilidades proporcionadas por la mcp-ts-template :

• Registro : registro estructurado y configurable (rotación de archivos, consola, notificaciones MCP) con redacción de datos confidenciales.

• Manejo de errores : procesamiento de errores centralizado, tipos de errores estandarizados ( McpError ) y registro automático.

• Configuración : Carga de variable de entorno ( dotenv ).

• Validación/saneamiento de entrada : utiliza zod para la validación del esquema y la lógica de saneamiento personalizada (crucial para las rutas).

• Contexto de solicitud : seguimiento y correlación de operaciones a través de identificadores de solicitud únicos.

• Seguridad de tipos : tipado fuerte impuesto por los esquemas TypeScript y Zod.

• Opción de transporte HTTP : servidor Express integrado con SSE, administración de sesiones y compatibilidad con CORS.

Operaciones de Git

• Ejecución directa de Git CLI : interactúa con Git ejecutando de forma segura la herramienta de línea de comandos git estándar a través de child_process de Node.js, lo que garantiza la compatibilidad total y el acceso a las funciones de Git.

• Cobertura integral de comandos : expone una amplia gama de comandos Git como herramientas MCP (consulte la sección Herramientas ).

• Interacción del repositorio : admite verificación de estado, ramificación, preparación, confirmación, búsqueda, extracción, envío, comparación, registro, restablecimiento, etiquetado y más.

• Administración del directorio de trabajo : permite configurar y borrar un directorio de trabajo específico de la sesión para la persistencia del contexto en múltiples operaciones de Git.

• Características de seguridad : incluye controles y requiere confirmación explícita para operaciones potencialmente destructivas como git clean y git reset --hard .

• Firma de confirmaciones : Admite la firma GPG o SSH para confirmaciones verificadas, controlada mediante la variable de entorno GIT_SIGN_COMMITS y la configuración de Git del servidor. Incluye un parámetro de herramienta opcional para recurrir a confirmaciones sin firmar en caso de fallo de firma.

Instalación

Prerrequisitos

• Node.js (>=18.0.0)

• npm (viene con Node.js)

• Git instalado y accesible en la RUTA del sistema.

Instalar mediante npm

1. Instalar el paquete globalmente:

   npm install @cyanheads/git-mcp-server

Instalar desde la fuente

1. Clonar el repositorio:

   git clone https://github.com/cyanheads/git-mcp-server.git cd git-mcp-server

2. Instalar dependencias:

   npm install

3. Construir el proyecto:

   npm run build (or `npm run rebuild`)

   Esto compila el código TypeScript a JavaScript en el directorio dist/ y hace que el punto de entrada sea ejecutable.

Configuración

Variables de entorno

Configure el servidor mediante variables de entorno. Cree un archivo .env en la raíz del proyecto (cópielo de .env.example ) o configúrelo en su entorno.

Configuración del cliente MCP

Agregue a la configuración de su cliente MCP (por ejemplo, cline_mcp_settings.json ):

Estructura del proyecto

La base del código sigue una estructura modular dentro del directorio src/ :

Para obtener un árbol de archivos detallado, ejecute npm run tree o consulte docs/tree.md .

Herramientas

El servidor Git MCP proporciona un conjunto de herramientas para interactuar con repositorios Git, a las que se puede llamar a través del Protocolo de contexto de modelo.

Nota: El parámetro

Recursos

Los recursos de MCP no están implementados en esta versión (v2.0.12).

Esta versión se centra en la implementación refactorizada de las herramientas Git, basada en la última mcp-ts-template y el SDK de MCP v1.12.0. Las funciones de recursos, previamente disponibles, se han eliminado temporalmente durante esta importante actualización.

Si necesita acceso a recursos MCP (por ejemplo, para leer el contenido del archivo directamente a través del servidor), utilice la versión estable v1.2.4 .

Es posible que el desarrollo futuro vuelva a introducir capacidades de recursos en una versión posterior.

Nota: Esta versión (v2.0.0) se centra en la refactorización y actualización de las herramientas principales de Git basadas en el último SDK de MCP. Las funciones de recursos de MCP no están implementadas en esta versión. Para acceder a los recursos, utilice la versión v1.2.4 .

Desarrollo

Construir y probar

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0: consulte el archivo de LICENCIA para obtener más detalles.