Just MCP Server — Claude Code MCP server: features and setup
This MCP server lets an agent inspect and run recipes from a Justfile. Use it to expose project commands without asking the agent to work out Just syntax itself.
claude mcp add just-mcp-server -- docker run -i --rm ghcr.io/promptexecution/just-mcp:0.1.5What Just MCP Server does
Just MCP Server connects a Justfile to an agent through MCP. Its tools can list recipes, return a recipe’s documentation and parameters, check the file for syntax or semantic errors, and run a recipe with arguments. Results from execution are captured as structured output.
The Claude Code setup command starts the server in Docker with ghcr.io/promptexecution/just-mcp:0.1.5. Recipes are executable actions, so review what your Justfile allows before giving the agent access. This interface exposes Just recipes rather than unrestricted shell commands.
What it helps with
- list the recipes in a project Justfile
- inspect a recipe’s arguments and documentation
- check a Justfile for syntax errors
- run a project recipe with arguments
Example prompts for the agent
- List the recipes available in this project’s Justfile.
- Check the Justfile for syntax and semantic errors.
- Run the build recipe with the
releaseargument.
How to install Just MCP Server
Platform CLI
claude mcp add just-mcp-server -- docker run -i --rm ghcr.io/promptexecution/just-mcp:0.1.5Platform CLI
codex mcp add just-mcp-server -- docker run -i --rm ghcr.io/promptexecution/just-mcp:0.1.5Config file
{
"mcpServers": {
"just-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/promptexecution/just-mcp:0.1.5"
]
}
}
}Config file
{
"servers": {
"just-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/promptexecution/just-mcp:0.1.5"
]
}
}
}Platform CLI
gemini mcp add just-mcp-server docker run -i --rm ghcr.io/promptexecution/just-mcp:0.1.5Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Just MCP Server
How do I install Just MCP Server in Claude Code?
Run claude mcp add just-mcp-server -- docker run -i --rm ghcr.io/promptexecution/just-mcp:0.1.5. This setup uses Docker.
What does Just MCP Server do?
It provides MCP tools to inspect Justfile recipes, check the file, and execute recipes with arguments. The agent can also retrieve recipe details and parameters.
Does Just MCP Server need a Justfile?
Yes. It discovers and runs recipes from a Justfile, and can validate that file’s syntax and semantics.
