Make

Ejecuta objetivos de make desde cualquier Makefile en un entorno seguro y controlado.

Documentación

MCP Server Make

CI Release PyPI version

Un servidor de Model Context Protocol que proporciona funcionalidad de make. Este servidor permite a los LLM ejecutar objetivos de make desde cualquier Makefile de forma segura y controlada.

Descripción general

El servidor expone la funcionalidad de make a través del Model Context Protocol, permitiendo a LLM como Claude:

  • Ejecutar objetivos de make de forma segura con captura de salida
  • Comprender y navegar por los procesos de compilación
  • Ayudar con tareas de desarrollo
  • Manejar errores de forma adecuada
  • Respetar el contexto del directorio de trabajo

MCP Server Make funciona con cualquier Makefile válido: puedes usar el Makefile opinado incluido o tus propios scripts de compilación personalizados.

Inicio rápido

Instalación

Usando uv (recomendado):

uv pip install mcp-server-make

Usando pip:

pip install mcp-server-make

Uso básico

# Run with default Makefile in current directory
uvx mcp-server-make

# Run with specific Makefile and working directory
uvx mcp-server-make --make-path /path/to/Makefile --working-dir /path/to/working/dir

Configuración del cliente MCP

Para usar con Claude Desktop, añade a tu configuración de Claude (claude_desktop_config.json):

{
  "mcpServers": {
    "make": {
      "command": "uvx",
      "args": [
        "mcp-server-make",
        "--make-path", "/absolute/path/to/Makefile",
        "--working-dir", "/absolute/path/to/working/dir"
      ]
    }
  }
}

Documentación

Para obtener información detallada sobre el uso de MCP Server Make, consulta nuestra documentación:

Mejorando los flujos de trabajo de desarrollo

Este servidor habilita potentes flujos de trabajo de desarrollo al dar a los LLM acceso directo a la funcionalidad de make:

Para desarrolladores

  1. Asistencia automatizada

    • Deja que Claude ejecute e interprete los resultados de las pruebas
    • Obtén sugerencias y mejoras para el sistema de compilación
    • Automatiza tareas de desarrollo repetitivas
  2. Gestión de proyectos

    • Deja que Claude gestione las actualizaciones de dependencias
    • Automatiza los procesos de publicación
    • Mantén una calidad de código consistente

Trabajando con objetivos de make

MCP Server Make no descubre automáticamente los objetivos disponibles en tu Makefile. Para usarlo eficazmente con Claude:

  1. Empieza con make help: La mayoría de los Makefiles bien diseñados incluyen un objetivo de ayuda

    Human: Please run make help to see what commands are available.
    
  2. Informa a Claude sobre tus objetivos: Menciona explícitamente los objetivos disponibles y su propósito

    Human: Our project has these make targets: test, lint, format, build, and clean.
    
  3. Usa convenciones estándar: Objetivos comunes que muchos Makefiles incluyen:

    • make test - Ejecutar pruebas
    • make lint - Verificar la calidad del código
    • make format - Formatear código
    • make build - Compilar el proyecto
    • make clean - Limpiar artefactos de compilación

El repositorio incluye un Makefile opinado con objetivos de utilidad adicionales: consulta la Guía de usuario para obtener detalles sobre estas capacidades ampliadas o para crear tus propios objetivos personalizados.

Nota: Claude no recuerda los objetivos disponibles entre conversaciones. Tendrás que presentarlos al inicio de cada conversación.

Ejemplo de integración

Así es como Claude puede ayudar con tareas de desarrollo:

Human: Can you run our test suite and format any code that needs it?

Claude: I'll help run the tests and format the code:

1. First, let's format the code:
[Calling make tool with args {"target": "format"}]
2 files reformatted, 3 files left unchanged

2. Now let's run the tests:
[Calling make tool with args {"target": "test"}]
Running tests...
4 passed, 0 failed

All formatting and tests completed successfully. The code is now properly formatted and all tests are passing.

Herramientas disponibles

El servidor expone una única herramienta:

  • make - Ejecutar un objetivo de make desde el Makefile
    • target (string, obligatorio): Nombre del objetivo a ejecutar

Contribuciones

¡Agradecemos las contribuciones para mejorar mcp-server-make! Consulta CONTRIBUTING.md para obtener instrucciones detalladas sobre cómo configurar tu entorno de desarrollo, usar las herramientas del proyecto y enviar cambios.

Licencia

Licencia MIT: consulta el archivo LICENSE para obtener más detalles.