Improve CLI help system and command descriptions

- Update main CLI description to be more direct about MCPM capabilities
- Improve client and profile command descriptions with specific examples
- Add consistent grey-purple footer to all commands for GitHub issues
- Remove header/footer from subcommands while keeping for main CLI help
- Implement custom help handling for main command with proper header/footer display
- Remove duplicate information and streamline footer messaging
- Use Text objects instead of markup strings to fix rendering issues

Key improvements:
- Main CLI: Centralized MCP server management with clear value proposition
- Client command: Explains MCP clients and supported applications
- Profile command: Describes workflow organization with concrete examples
- Consistent support footer across all commands with proper styling
- Clean main command help with ASCII art header and minimal footer

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: niechen

src/mcpm/cli.py

@@ -27,16 +27,16 @@
 from mcpm.commands.share import share
 from mcpm.migration import V1ConfigDetector, V1ToV2Migrator
 from mcpm.utils.logging_config import setup_logging
-from mcpm.utils.rich_click_config import click
+from mcpm.utils.rich_click_config import click, get_header_text, get_footer_text
 
 console = Console()
 client_config_manager = ClientConfigManager()
 
 # Setup Rich logging early - this runs when the module is imported
 setup_logging()
 
-# Let rich-click handle help display
-CONTEXT_SETTINGS = dict(help_option_names=["-h", "--help"])
+# Custom context settings to handle main command help specially
+CONTEXT_SETTINGS = dict(help_option_names=[])
 
 
 def print_logo():
@@ -129,18 +129,32 @@ def wrapper(*args, **kwargs):
     context_settings=CONTEXT_SETTINGS,
     invoke_without_command=True,
     help="""
-A simplified tool for managing MCP servers in a global configuration.
-Install servers, organize them with profiles, and run them directly.
+Centralized MCP server management - discover, install, run, and share servers.
+
+Manage servers globally, organize with profiles, monitor usage, and integrate 
+with all MCP clients.
 """,
 )
 @click.option("-v", "--version", is_flag=True, help="Show version and exit.")
+@click.option("-h", "--help", "help_flag", is_flag=True, help="Show this message and exit.")
 @click.pass_context
 @handle_exceptions
-def main(ctx, version):
+def main(ctx, version, help_flag):
     """Main entry point for MCPM CLI."""
     if version:
         print_logo()
         return
+    
+    if help_flag:
+        # Show custom help with header and footer for main command only
+        console.print(get_header_text())
+        # Temporarily disable global footer to avoid duplication
+        original_footer = click.rich_click.FOOTER_TEXT
+        click.rich_click.FOOTER_TEXT = None
+        click.echo(ctx.get_help())
+        click.rich_click.FOOTER_TEXT = original_footer
+        console.print(get_footer_text())
+        return
 
     # Check for v1 configuration and offer migration (even with subcommands)
     detector = V1ConfigDetector()
@@ -155,9 +169,15 @@ def main(ctx, version):
             # Continue to execute the subcommand
         # If "ignore", continue to subcommand without migration
 
-    # If no command was invoked, show help
+    # If no command was invoked, show help with header and footer
     if ctx.invoked_subcommand is None:
+        console.print(get_header_text())
+        # Temporarily disable global footer to avoid duplication
+        original_footer = click.rich_click.FOOTER_TEXT
+        click.rich_click.FOOTER_TEXT = None
         click.echo(ctx.get_help())
+        click.rich_click.FOOTER_TEXT = original_footer
+        console.print(get_footer_text())
 
 
 # Register v2.0 commands

src/mcpm/commands/client.py

@@ -25,11 +25,13 @@
 
 @click.group(context_settings=dict(help_option_names=["-h", "--help"]))
 def client():
-    """Manage MCP client configurations and MCPM server integrations.
+    """Manage MCP client configurations (Claude Desktop, Cursor, Windsurf, etc.).
 
-    Commands for listing clients, managing which MCPM servers are enabled
-    in specific MCP client configurations, and importing server configurations
-    from clients into MCPM.
+    MCP clients are applications that can connect to MCP servers. This command helps you
+    view installed clients, edit their configurations to enable/disable MCPM servers,
+    and import existing server configurations into MCPM's global configuration.
+
+    Supported clients: Claude Desktop, Cursor, Windsurf, Continue, Zed, and more.
 
     Examples:
 

src/mcpm/commands/profile/__init__.py

@@ -14,7 +14,13 @@
 @click.group()
 @click.help_option("-h", "--help")
 def profile():
-    """Manage MCPM profiles."""
+    """Manage MCPM profiles - collections of servers for different workflows.
+
+    Profiles are named groups of MCP servers that work together for specific tasks or
+    projects. They allow you to organize servers by purpose (e.g., 'web-dev', 'data-analysis')
+    and run multiple related servers simultaneously through FastMCP proxy aggregation.
+
+    Examples: 'frontend' profile with browser + github servers, 'research' with filesystem + web tools."""
     pass
 
 

src/mcpm/utils/rich_click_config.py

@@ -63,17 +63,21 @@
 header_text.append(" by Path Integral Institute", style="#FED2E2")
 
 footer_text = Text()
-footer_text.append("\n")
-footer_text.append("◈ Feedback and Support:", style="#8F87F1 bold")
-footer_text.append("\n  ")
-footer_text.append("🐛 Report a bug:", style="#C68EFD bold")
-footer_text.append(" https://github.com/pathintegral-institute/mcpm.sh/issues", style="#E9A5F1")
-footer_text.append("\n  ")
-footer_text.append("💬 Join discussion:", style="#E9A5F1 bold")
-footer_text.append(" https://github.com/pathintegral-institute/mcpm.sh/discussions", style="#FED2E2")
-
-click.rich_click.HEADER_TEXT = header_text
-click.rich_click.FOOTER_TEXT = footer_text
+footer_text.append("")
+
+# Export header and footer for use in main command
+def get_header_text():
+    return header_text
+
+def get_footer_text():
+    return footer_text
+
+# Add subtle footer to all commands using Text object to avoid literal markup
+global_footer_text = Text()
+global_footer_text.append("💬 Report bugs or request features: ", style="#8B7DB8")
+global_footer_text.append("https://github.com/pathintegral-institute/mcpm.sh/issues", style="#8B7DB8")
+
+click.rich_click.FOOTER_TEXT = global_footer_text
 
 # Enable custom formatting 
 click.rich_click.GROUP_ARGUMENTS_OPTIONS = True