Git Stuff Server

Servidor de cosas Git

Este repositorio contiene una aplicación Node.js que actúa como servidor MCP (Protocolo de Contexto de Modelo) para proporcionar funcionalidades relacionadas con Git. Actualmente, ofrece una herramienta para generar la diferencia de una confirmación de fusión de Git con su primer padre.

Características

• Servidor MCP: se ejecuta como un servidor MCP estándar utilizando stdio para la comunicación.
• Herramienta get_git_merge_diff :
  • Acepta un hash de confirmación de fusión de Git.
  • Ejecuta el script de PowerShell GenerateMergeDiff.ps1 .
  • Devuelve el contenido de diferencia textual generado por git show -m --first-parent <commitHash> .

Prerrequisitos

• Node.js (versión compatible con módulos ES, verifique engines en package.json si se especifica; de lo contrario, verifique el destino tsconfig.json - ES2022)
• npm (normalmente viene con Node.js)
• Git instalado y accesible en el PATH del sistema.
• PowerShell (Windows) o pwsh (Linux/macOS) instalado y accesible en la RUTA del sistema.

Instalación

1. Clonar el repositorio:
   git clone <your-repo-url> cd GitStuffServer
2. Instalar dependencias:
   npm install

Uso

1. Construya el código TypeScript:
   npm run build
   Esto compila el código TypeScript de src/ a JavaScript en build/ .
2. Ejecutar el servidor:
   • Para ejecutar el código compilado:
     npm start
   • Para compilar y ejecutar en modo de desarrollo:
     npm run dev

El servidor se iniciará y escuchará las solicitudes MCP en la entrada/salida estándar.

Uso de la herramienta get_git_merge_diff

Cuando se conecta a través de un cliente MCP, puede llamar a la herramienta get_git_merge_diff con la siguiente entrada:

• commitHash (cadena): el hash de confirmación de Git (SHA) de la confirmación de fusión que desea comparar.

La herramienta devolverá el contenido diferente como texto.

Cómo funciona

1. El servidor MCP ( src/index.ts ) recibe una solicitud para la herramienta get_git_merge_diff .
2. Valida la entrada commitHash .
3. Ejecuta el script de PowerShell GenerateMergeDiff.ps1 , pasando el commitHash .
4. El script de PowerShell ejecuta git show -m --first-parent <commitHash> y guarda la salida (incluidos los errores) en un archivo temporal llamado merge_changes.diff en el directorio de trabajo actual del servidor.
5. El servidor Node.js lee el contenido de merge_changes.diff .
6. El servidor elimina el archivo temporal merge_changes.diff .
7. El servidor devuelve el contenido de la diferencia (o un mensaje de error) al cliente MCP.

Configuración

Los puntos de configuración clave se definen como constantes dentro de src/index.ts :

• SERVER_NAME : El nombre registrado por el servidor MCP.
• SCRIPT_NAME : El nombre del archivo del script de PowerShell a ejecutar.
• OUTPUT_DIFF_FILE : El nombre del archivo de diferencias temporal creado por el script.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo package.json para obtener más detalles.