makefile-mcp

MCP server for working with Makefile targets.

Install

Install and configure the MCP from https://mcginniscommawill.com/oss/makefile-mcp/ now. Follow the documentation's installation instructions, ask me for anything you can't complete yourself, and verify its tools load.

View documentation

README

Languages

Python 99.6%

Top Contributors

Project Info

Created

February 15, 2026

Last Updated

October 3, 2026

License

MIT

Default Branch

main

About This Project

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