Make

Provides make target execution via MCP to run and manage Makefile targets safely.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run Makefile targets from an MCP client through a dedicated MCP server that safely executes make commands inside a specified project directory. This server handles target execution, captures output, and preserves the working directory context to help large language models automate build and development tasks with reliable results.

How to use

You interact with the Make MCP server through an MCP client by invoking the local stdio server that wraps the make workflow. Use it to run a specific target from your Makefile, with the option to set the Makefile location and the working directory. The server ensures proper error handling and preserves the original environment after execution.

How to install

Install the MCP server using Python or a lightweight runner as shown.

uv pip install mcp-server-make

""" This installs the MCP server package for Python environments using the uv runner. """

## Configuration and usage details

Configure the MCP client to point at the local stdio MCP server. You run the server with a Makefile path and a working directory, so the client can execute targets in the correct location.

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

## Configuration specifics for code execution

The server exposes a single tool named make. It executes a target from the Makefile you specify.

Example configuration for an MCP client to use a specific Makefile and working directory is shown above. The server will switch to the provided working directory before running the requested target and restore the original directory after execution.

## Troubleshooting and tips

If you encounter issues, verify the Makefile path exists and that the working directory is accessible. Common problems include missing Makefile, invalid targets, or directory permissions. The server returns descriptive errors through the MCP protocol to help you diagnose and fix problems quickly.

## Available tools

### make

Run a make target from the Makefile with a specified target name. This tool executes the target securely, captures output, and respects the working directory context.