Just

Provides an MCP server that lets LLMs discover, execute, and introspect Justfile recipes through the MCP protocol.

rust

42

GitHub Stars

rust

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "promptexecution-just-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "just-mcp",
        "--stdio"
      ]
    }
  }
}

You have a production-ready MCP server that enables AI assistants to discover, execute, and introspect Justfile recipes through the standardized MCP protocol. This server integrates Just with the MCP framework to provide safe, context-preserving command execution for agents and models with optional safety patterns and detailed introspection of recipes.

How to use

You interact with the Just MCP Server through an MCP client. Start the server locally or connect to a remote instance, then perform these common patterns: discover available recipes, execute a recipe with arguments, and fetch detailed information about a recipe. The server translates your MCP requests into Justfile operations and returns structured results that you can rely on for downstream decision making.

How to install

Prerequisites vary by installation method. Choose the option that fits your environment and follow the specific commands.

Additional setup notes

The server supports both local, stdio-based operation and remote HTTP-based endpoints. Use the provided examples to ensure you start with a correct command line or container configuration. You can run the MCP server with direct commands or via Docker to keep your host environment isolated.

Security and safety considerations

Leverage the server’s built‑in safety patterns to minimize risk when executing recipes. These include transparent logging, secondary model inspection, and idempotent execution backed by versioned Justfiles. Always review parameters and validate inputs before execution to protect your environment.

Usage examples

Example workflows show how to list available recipes, run a specific recipe with arguments, and fetch information about a recipe. Use these patterns within your MCP client to integrate Justfile capabilities into your agents.

Troubleshooting tips

If you encounter issues, verify the server is reachable, the Justfile is valid, and the requested recipe exists. Check environment configuration, ensure the MCP client is using the correct command and arguments, and review logs for any execution errors.

Power users notes

Advanced users can leverage environment management, YAML/JSON documentation, and structured outputs to integrate the Just MCP Server into larger agent pipelines. Consider enabling secondary model inspection for sensitive or high-risk commands.

Available tools

list_recipes

List all available recipes in the justfile.

run_recipe

Execute a specific recipe with optional arguments.

get_recipe_info

Get detailed information about a specific recipe.

validate_justfile

Validate the justfile for syntax and semantic errors.