Makefile MCP server

by ai-ronin-systems·io.github.ai-ronin-systems/makefile-mcp·v0.3.0

No reviews yet

Expose trusted GNU Make targets as governed MCP tools without a generic shell.

A89/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A89/100

not scanned yet

Adoption

Growing

0 stars13 downloads/wk

Reviews

Write one

Nobody has reviewed Makefile MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Makefile MCP tools

No tool declarations could be read from the package source. They show once the server is installed.

Not scanned yet. New listings are scanned within a day or two of arriving.

How Makefile MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 89/100; higher than 80% of 48,255 servers
Downloads a week: 13; more than 4% of 12,191 servers with a package

Release history: 2 versions in the registry since 2026-10-15, latest 2026-10-25, typically one every 10 days.

Install Makefile MCP in Claude Code, Cursor or VS Code

claude mcp add makefile-mcp -- uvx makefile-mcp

Add to Cursor

What the publisher says

From the Makefile MCP repository's README, as published. We do not edit it. Read it on GitHub

Makefile MCP

Expose trusted GNU Make targets to AI agents — without exposing a generic shell or replacing Make with another workflow system.

Makefile MCP turns an existing Makefile into typed MCP tools. It is zero-config and run-safe by default, and deny-by-default when governed.

Makefile  →  Makefile MCP  →  Codex / Claude / LangChain / Cursor / VS Code / MCP client

Threat model

Details: SECURITY.md and docs/security.md.

Quick start

pipx install makefile-mcp        # or: uv tool install makefile-mcp
makefile-mcp serve

Given:

test: ## Run tests
	pytest -q

lint: ## Run lint
	ruff check .

Makefile MCP exposes maketest and makelint as MCP tools. Other targets are listed but not runnable until you govern them.

makefile-mcp list
makefile-mcp doctor
makefile-mcp run test
makefile-mcp run test --preview   # GNU Make --dry-run; not a sandbox

One-shot use: uvx makefile-mcp serve.

Why Makefile MCP

Makefile MCP is intentionally narrow: the repository's Makefile remains the executable source of truth, while Makefile MCP supplies a governed agent-facing capability boundary.

See Design rationale for the full capability/property map and the alternatives deliberately left out.

Architecture

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Makefile MCP: common questions

Is Makefile MCP server safe?: Yes, by our scan: it is graded A (89/100). Read the Makefile MCP safety report
How do I install Makefile MCP?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Makefile MCP need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Makefile MCP maintained?: The last commit was 20 days ago (2026-10-15). The latest release is v0.3.0.
How does Makefile MCP compare with other MCP servers?: safety score 89/100 (higher than 80% of 48,255 servers); downloads a week 13 (more than 4% of 12,191 servers with a package). Full comparison.