clap-mcp 0.0.5

Enrich your CLI with MCP capabilities
Documentation 
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

//! Canonical complex CLI shape for macro regression tests.
//!
//! Combines struct-root `output_from`, multi-level `schema_only` nesting, nested
//! `skip`, skipped multi-positional siblings, `requires`, and `serialized` in one tree.

use clap::{Parser, Subcommand};
use clap_mcp::ClapMcp;

#[derive(Debug, Parser, ClapMcp)]
#[clap_mcp(reinvocation_safe, parallel_safe = false)]
#[clap_mcp_output_from = "run_complex"]
#[command(name = "test-complex-cli", subcommand_required = true)]
pub struct TestComplexCli {
    #[arg(long, global = true)]
    pub verbose: bool,
    #[command(subcommand)]
    pub command: TestComplexTop,
}

#[derive(Debug, Subcommand, ClapMcp)]
#[clap_mcp(schema_only)]
pub enum TestComplexTop {
    Sandbox {
        #[command(subcommand)]
        command: TestComplexSandbox,
    },
    #[clap_mcp(skip)]
    Upload { name: String, local_path: String },
    #[clap_mcp(serialized)]
    Snapshot,
}

#[derive(Debug, Subcommand, ClapMcp)]
#[clap_mcp(schema_only)]
pub enum TestComplexSandbox {
    Leaf {
        #[clap_mcp(requires = "name")]
        #[arg(long)]
        name: Option<String>,
    },
    #[clap_mcp(skip)]
    Connect,
}

pub fn run_complex(cli: TestComplexCli) -> String {
    match cli.command {
        TestComplexTop::Sandbox { command } => run_complex_sandbox(command, cli.verbose),
        TestComplexTop::Upload { name, local_path } => format!("upload:{name}:{local_path}"),
        TestComplexTop::Snapshot => format!("snapshot:verbose={}", cli.verbose),
    }
}

fn run_complex_sandbox(cmd: TestComplexSandbox, verbose: bool) -> String {
    match cmd {
        TestComplexSandbox::Leaf { name } => {
            format!(
                "leaf:{}:verbose={}",
                name.as_deref().unwrap_or("anon"),
                verbose
            )
        }
        TestComplexSandbox::Connect => "connect".to_string(),
    }
}