makefile-mcp

Makefile MCP turns your Makefile targets into MCP tools that AI assistants can discover and run. Each target becomes a callable tool (e.g., make_build, make_test), bridging your build system and AI workflows.

Features

• Dynamic Tool Generation: Each Makefile target automatically becomes an MCP tool
• Description Extraction: Pulls target descriptions from Makefile comments
• Include/Exclude Filtering: Control which targets are exposed to AI assistants
• Built-in Metadata Tools: list-available-targets and get-makefile-info for discovery
• Dry-Run Mode: Preview what a target would do without executing it

Installation

# Run directly
uvx --from git+https://github.com/wdm0006/makefile-mcp makefile-mcp

# Or add to your MCP client config
{
  "mcpServers": {
    "makefile": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/wdm0006/makefile-mcp", "makefile-mcp"]
    }
  }
}

Usage

Point the server at your Makefile and it discovers all targets. AI assistants can then list available targets, inspect what they do, and execute them directly.

# With custom Makefile location
makefile-mcp --makefile /path/to/Makefile --working-dir /path/to/project