Just MCP Server
Expose only approved Justfile recipes to your agent so automation stays deterministic and bounded.
Overview
Just MCP Server is a MCP server for the Build phase that exposes curated Justfile recipes to AI clients for safe deterministic automation over stdio.
What is this MCP server?
- Curated Justfile recipes exposed as MCP tools—not open-ended shell
- OCI image ghcr.io/promptexecution/just-mcp:0.1.5 for containerized stdio deploy
- Emphasizes safe, deterministic automation for repeatable dev tasks
- Version 0.1.5 on MCP schema 2025-10-17
- Fits repos that already standardize on the Just command runner
- OCI identifier: ghcr.io/promptexecution/just-mcp:0.1.5
- Transport: stdio; repository: github.com/PromptExecution/just-mcp
Community signal: 50 GitHub stars.
What problem does it solve?
Letting agents run freeform shell is risky; you want them on your Just recipes without re-explaining every command each session.
Who is it for?
Indie devs with Just-based repo automation who want Cursor or Claude Code to run tests, builds, and chores via approved recipes only.
Skip if: Repos with no Justfile, or teams that need arbitrary unconstrained terminal access for agents.
What do I get? / Deliverables
After registration, the agent calls named Just targets through MCP with the same boundaries you defined in your Justfile.
- MCP tools mapped to selected Just recipes
- Container-pinning option at image tag 0.1.5
- Reduced arbitrary-shell risk for agent-driven repo tasks
Recommended MCP Servers
Journey fit
While building, you wire local automation and repo scripts that agents must run safely alongside application code. Just MCP sits in integrations because it bridges your Justfile command layer to MCP without giving the model arbitrary shell.
How it compares
Justfile recipe MCP gateway, not a Makefile linter skill or full CI platform.
Common Questions / FAQ
Who is Just MCP Server for?
Developers who standardize tasks in Justfiles and want MCP tools that expose only those recipes to AI coding agents.
When should I use Just MCP Server?
Use it while building and maintaining a repo when agents should run lint, test, codegen, or deploy shortcuts deterministically through Just instead of ad hoc bash.
How do I add Just MCP Server to my agent?
Pull ghcr.io/promptexecution/just-mcp:0.1.5 (or equivalent stdio setup), mount or copy your project with a Justfile, configure the MCP stdio server in your client, and point recipe exposure at your curated Just targets.