just-mcp 0.1.1

Production-ready MCP (Model Context Protocol) server for Justfile integration
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

use clap::{Arg, Command};
use just_mcp_lib::mcp_server::JustMcpServer;
use rmcp::{ServiceExt, transport::stdio};
use std::error::Error;
use std::path::Path;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let matches = Command::new("just-mcp")
        .version(env!("CARGO_PKG_VERSION"))
        .author("just-mcp contributors")
        .about("MCP Server for Justfile Integration")
        .arg(
            Arg::new("working-dir")
                .short('d')
                .long("directory")
                .value_name("DIR")
                .help("Working directory for the MCP server")
                .default_value("."),
        )
        .arg(
            Arg::new("stdio")
                .long("stdio")
                .help("Run as MCP server using stdio transport")
                .action(clap::ArgAction::SetTrue),
        )
        .get_matches();

    let working_dir = matches.get_one::<String>("working-dir").unwrap();
    let working_path = Path::new(working_dir);

    if matches.get_flag("stdio") {
        // Run as MCP server
        eprintln!(
            "Starting just-mcp MCP server in directory: {}",
            working_path.display()
        );

        let server = JustMcpServer::new(working_path);

        // Start the MCP server with stdio transport
        let running_service = server.serve(stdio()).await?;

        // Keep the server running
        running_service.waiting().await?;
    } else {
        // Show usage information
        println!("just-mcp v{}", env!("CARGO_PKG_VERSION"));
        println!("MCP Server for Justfile Integration");
        println!();
        println!("Usage:");
        println!(
            "  {} --stdio                    Run as MCP server with stdio transport",
            env!("CARGO_PKG_NAME")
        );
        println!(
            "  {} --directory <DIR> --stdio  Run MCP server in specific directory",
            env!("CARGO_PKG_NAME")
        );
        println!();
        println!("MCP Tools Available:");
        println!("  list_recipes      - List all available recipes in the justfile");
        println!("  run_recipe        - Execute a specific recipe with optional arguments");
        println!("  get_recipe_info   - Get detailed information about a specific recipe");
        println!("  validate_justfile - Validate the justfile for syntax and semantic errors");
        println!();
        println!("Example usage with MCP client:");
        println!("  {} --stdio | your-mcp-client", env!("CARGO_PKG_NAME"));
    }

    Ok(())
}