feat: add help info for all commands

Author: JoJoJoJoJoJoJo

src/mcpm/cli.py

@@ -126,14 +126,10 @@ def main(ctx, help_flag):
         commands_table.add_row("[yellow]server[/]")
         commands_table.add_row("  [cyan]search[/]", "Search available MCP servers.")
         commands_table.add_row("  [cyan]add[/]", "Add an MCP server directly to a client.")
-        commands_table.add_row("  [cyan]cp[/]")
-        commands_table.add_row("  [cyan]copy[/]", "Copy a server from one client/profile to another.")
-        commands_table.add_row("  [cyan]mv[/]")
-        commands_table.add_row("  [cyan]move[/]", "Move a server from one client/profile to another.")
-        commands_table.add_row("  [cyan]rm[/]")
-        commands_table.add_row("  [cyan]remove[/]", "Remove an installed MCP server.")
-        commands_table.add_row("  [cyan]ls[/]")
-        commands_table.add_row("  [cyan]list[/]", "List all installed MCP servers.")
+        commands_table.add_row("  [cyan]cp[/]", "Copy a server from one client/profile to another.")
+        commands_table.add_row("  [cyan]mv[/]", "Move a server from one client/profile to another.")
+        commands_table.add_row("  [cyan]rm[/]", "Remove an installed MCP server.")
+        commands_table.add_row("  [cyan]ls[/]", "List all installed MCP servers.")
         commands_table.add_row("  [cyan]stash[/]", "Temporarily store a server configuration aside.")
         commands_table.add_row("  [cyan]pop[/]", "Restore a previously stashed server configuration.")
 
@@ -152,15 +148,13 @@ def main(ctx, help_flag):
 
         # Additional helpful information
         console.print("")
-        console.print("[italic]Run [bold]mcpm -h[/] for more information on a command.[/]")
+        console.print("[italic]Run [bold]mcpm COMMAND -h[/] for more information on a command.[/]")
 
 
 # Register commands
 main.add_command(search.search)
-main.add_command(remove.remove)
 main.add_command(remove.remove, name="rm")
 main.add_command(add.add)
-main.add_command(list.list)
 main.add_command(list.list, name="ls")
 
 main.add_command(stash.stash)
@@ -170,9 +164,7 @@ def main(ctx, help_flag):
 main.add_command(config.config)
 main.add_command(inspector.inspector, name="inspector")
 main.add_command(profile.profile, name="profile")
-main.add_command(transfer.move)
 main.add_command(transfer.move, name="mv")
-main.add_command(transfer.copy)
 main.add_command(transfer.copy, name="cp")
 main.add_command(profile.activate)
 main.add_command(profile.deactivate)

src/mcpm/commands/config.py

@@ -12,6 +12,7 @@
 
 
 @click.group()
+@click.help_option("-h", "--help")
 def config():
     """Manage MCPM configuration.
 
@@ -21,6 +22,7 @@ def config():
 
 
 @config.command()
+@click.help_option("-h", "--help")
 def clear_cache():
     """Clear the local repository cache.
 

src/mcpm/commands/list.py

@@ -19,12 +19,15 @@
 
 @click.command(name="list")
 @click.option("--target", "-t", help="Target to list servers from")
+@click.help_option("-h", "--help")
 def list(target: str | None = None):
     """List all installed MCP servers.
 
     Examples:
+
+    \b
         mcpm list
-        mcpm list -t <scope>
+        mcpm list -t @cursor
     """
     if target is None:
         target = ClientRegistry.determine_active_scope()

src/mcpm/commands/profile.py

@@ -11,6 +11,7 @@
 
 
 @click.group()
+@click.help_option("-h", "--help")
 def profile():
     """Manage MCPM profiles."""
     pass
@@ -19,6 +20,7 @@ def profile():
 @click.command()
 @click.argument("profile_name")
 @click.option("--client", "-c", default="client", help="Client of the profile")
+@click.help_option("-h", "--help")
 def activate(profile_name, client):
     """Activate a profile.
 
@@ -41,6 +43,7 @@ def activate(profile_name, client):
 
 @click.command()
 @click.option("--client", "-c", default="client", help="Client of the profile")
+@click.help_option("-h", "--help")
 def deactivate(client):
     """Deactivate a profile.
 
@@ -63,6 +66,7 @@ def deactivate(client):
 
 @profile.command(name="ls")
 @click.option("--verbose", "-v", is_flag=True, help="Show detailed server information")
+@click.help_option("-h", "--help")
 def list(verbose=False):
     """List all MCPM profiles."""
     profiles = profile_config_manager.list_profiles()
@@ -93,6 +97,7 @@ def list(verbose=False):
 @profile.command()
 @click.argument("profile")
 @click.option("--force", is_flag=True, help="Force add even if profile already exists")
+@click.help_option("-h", "--help")
 def add(profile, force=False):
     """Add a new MCPM profile."""
     if profile_config_manager.get_profile(profile) is not None and not force:
@@ -112,6 +117,7 @@ def add(profile, force=False):
 @profile.command()
 @click.argument("profile")
 @click.option("--server", "-s", required=True, help="Server to apply config to")
+@click.help_option("-h", "--help")
 def apply(profile, server):
     """Apply an existing MCPM config to a profile."""
     client_manager = ClientRegistry.get_active_client_manager()
@@ -147,6 +153,7 @@ def apply(profile, server):
 
 @profile.command()
 @click.argument("profile_name")
+@click.help_option("-h", "--help")
 def remove(profile_name):
     """Delete an MCPM profile."""
     if not profile_config_manager.delete_profile(profile_name):
@@ -157,6 +164,7 @@ def remove(profile_name):
 
 @profile.command()
 @click.argument("profile_name")
+@click.help_option("-h", "--help")
 def rename(profile_name):
     """Rename an MCPM profile."""
     new_profile_name = click.prompt("Enter new profile name", type=str)

src/mcpm/commands/router.py

@@ -71,6 +71,7 @@ def remove_pid_file():
 
 
 @click.group(name="router")
+@click.help_option("-h", "--help")
 def router():
     """Manage MCP router service."""
     pass
@@ -80,10 +81,13 @@ def router():
 @click.option("--host", type=str, default="0.0.0.0", help="Host to bind the SSE server to")
 @click.option("--port", type=int, default=8080, help="Port to bind the SSE server to")
 @click.option("--cors", type=str, help="Comma-separated list of allowed origins for CORS")
+@click.help_option("-h", "--help")
 def start_router(host, port, cors):
     """Start MCPRouter as a daemon process.
 
     Example:
+
+    \b
         mcpm router on
         mcpm router on --port 8888
         mcpm router on --host 0.0.0.0 --port 9000
@@ -143,10 +147,13 @@ def start_router(host, port, cors):
 
 
 @router.command(name="off")
+@click.help_option("-h", "--help")
 def stop_router():
     """Stop the running MCPRouter daemon process.
 
     Example:
+
+    \b
         mcpm router off
     """
     # check if there is a router already running
@@ -172,10 +179,13 @@ def stop_router():
 
 
 @router.command(name="status")
+@click.help_option("-h", "--help")
 def router_status():
     """Check the status of the MCPRouter daemon process.
 
     Example:
+
+    \b
         mcpm router status
     """
     pid = read_pid_file()

src/mcpm/commands/search.py

@@ -15,12 +15,15 @@
 @click.command()
 @click.argument("query", required=False)
 @click.option("--detailed", is_flag=True, help="Show detailed server information")
+@click.help_option("-h", "--help")
 def search(query, detailed=False):
     """Search available MCP servers.
 
     Searches the MCP registry for available servers. Without arguments, lists all available servers.
 
     Examples:
+
+    \b
         mcpm search                  # List all available servers
         mcpm search github           # Search for github server
         mcpm search --detailed       # Show detailed information

src/mcpm/commands/server_operations/add.py

@@ -29,10 +29,13 @@
 @click.option("--force", is_flag=True, help="Force reinstall if server is already installed")
 @click.option("--alias", help="Alias for the server", required=False)
 @click.option("--target", "-t", help="Target to add server to", required=False)
+@click.help_option("-h", "--help")
 def add(server_name, force=False, alias=None, target: str | None = None):
     """Add an MCP server to a client configuration.
 
     Examples:
+
+    \b
         mcpm add time
         mcpm add everything --force
         mcpm add youtube --alias yt

src/mcpm/commands/server_operations/pop.py

@@ -20,14 +20,18 @@
 
 @click.command()
 @click.argument("server_name")
+@click.help_option("-h", "--help")
 def pop(server_name):
     """Restore a previously stashed server configuration.
 
     This command re-enables a previously stashed (disabled) server,
     restoring it to active status.
 
     Examples:
+
+    \b
         mcpm pop memory
+        mcpm pop %profile/memory
     """
     scope_type, scope, server_name = determine_target(server_name)
     if not scope_type or not scope or not server_name:

src/mcpm/commands/server_operations/remove.py

@@ -22,10 +22,13 @@
 @click.command()
 @click.argument("server_name")
 @click.option("--force", is_flag=True, help="Force removal without confirmation")
+@click.help_option("-h", "--help")
 def remove(server_name, force):
     """Remove an installed MCP server.
 
     Examples:
+
+    \b
         mcpm rm filesystem
         mcpm rm @cursor/filesystem
         mcpm rm %profile/filesystem

src/mcpm/commands/server_operations/stash.py

@@ -22,14 +22,19 @@
 
 @click.command()
 @click.argument("server_name")
+@click.help_option("-h", "--help")
 def stash(server_name):
     """Temporarily store a server configuration aside.
 
     This command disables an active server without removing it, storing its
     configuration for later use. You can restore it with the 'pop' command.
 
     Examples:
+
+    \b
         mcpm stash memory
+        mcpm stash @cursor/memory
+        mcpm stash %profile/memory
     """
     scope_type, scope, server_name = determine_target(server_name)
     if not scope_type or not scope or not server_name: