makefile-mcp

Languages

Python 99.6%

Top Contributors

Project Info

Created

February 15, 2026

Last Updated

September 8, 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