just-mcp

🥈Silver

just-mcp enables operations teams to share justfile tasks with AI Coding Agents, automating repetitive coding tasks. Benefits developers and operations teams by integrating with justfile workflows and supported AI agents like Claude.

4100Updated 2mo ago

Intermediate30min to implementautomation

Saves ~45 min per use

Quick InstallView Source

git clone https://github.com/toolprint/just-mcp.git

Works with:

Claude

Overview

About This Skill

just-mcp bridges justfiles and AI coding agents by transforming your project's automation tasks into MCP-accessible tools. The server uses AST-based parsing to discover justfile recipes, extract parameters and documentation, and expose them dynamically to Claude, Cursor, Cline, and other supported agents. Teams can monitor single or multiple projects with hot reloading, allowing AI assistants to understand and execute common development workflows without manual integration. Security features include input validation, timeouts, and directory whitelisting. Optional vector search provides semantic, natural-language task discovery across projects.

How to Use

Install just-mcp via cargo-binstall or download a pre-built binary, then configure it in your MCP client (Claude, Claude Desktop, or Cline) by adding the server configuration. The server automatically detects your justfile, parses recipes, and exposes them as tools—use slash commands like '/just:do-it build the project' to trigger execution.

Use Cases

Enable Claude to automatically run build, test, and deploy tasks from your justfile

Allow AI agents to discover and execute project-specific automation workflows

Share development workflow documentation with coding assistants through task parameters and comments

Monitor multiple projects and expose tasks to AI agents with custom namespace labels

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/toolprint/just-mcp

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I want to use just-mcp to automate a repetitive coding task. Here's my justfile task: [JUSTFILE_TASK]. The task involves [DESCRIBE_TASK]. Please generate the necessary code to complete this task using just-mcp and explain how it integrates with my workflow.

Example Output

# Automating Database Backup with just-mcp

## Task Overview
- **Description**: Automate daily database backups using just-mcp
- **Frequency**: Daily at 2 AM
- **Backup Location**: /backups/database

## Implementation
```bash
# justfile task
backup_database:
	pg_dump -U [USERNAME] -h [HOST] [DATABASE_NAME] > /backups/database/backup_$(date +%Y-%m-%d).sql

echo "Database backup completed successfully"
```

## Integration with just-mcp
1. **Task Sharing**: Share the `backup_database` task with AI Coding Agents via just-mcp
2. **Scheduling**: Set up a cron job to run the task daily at 2 AM
3. **Monitoring**: Use just-mcp to monitor task execution and receive notifications

## Benefits
- **Automation**: Reduces manual effort in performing repetitive tasks
- **Reliability**: Ensures tasks are completed consistently and on time
- **Scalability**: Easily add more tasks as needed