feat(cli): add more details for arguments mcp description

GH-0

Author: Akshat Dubey

packages/cli/README.md

@@ -15,33 +15,30 @@ Once the above command is executed, you will be able to access the CLI commands
 ## Usage
 
 <!-- usage -->
-
 ```sh-session
 $ npm install -g @sourceloop/cli
 $ sl COMMAND
 running command...
 $ sl (-v|--version|version)
-@sourceloop/cli/10.0.0 darwin-arm64 node-v20.19.2
+@sourceloop/cli/10.0.0 darwin-arm64 node-v24.2.0
 $ sl --help [COMMAND]
 USAGE
   $ sl COMMAND
 ...
 ```
-
 <!-- usagestop -->
 
 ## Commands
 
 <!-- commands -->
-
-- [`sl autocomplete [SHELL]`](#sl-autocomplete-shell)
-- [`sl cdk`](#sl-cdk)
-- [`sl extension [NAME]`](#sl-extension-name)
-- [`sl help [COMMAND]`](#sl-help-command)
-- [`sl mcp`](#sl-mcp)
-- [`sl microservice [NAME]`](#sl-microservice-name)
-- [`sl scaffold [NAME]`](#sl-scaffold-name)
-- [`sl update`](#sl-update)
+* [`sl autocomplete [SHELL]`](#sl-autocomplete-shell)
+* [`sl cdk`](#sl-cdk)
+* [`sl extension [NAME]`](#sl-extension-name)
+* [`sl help [COMMAND]`](#sl-help-command)
+* [`sl mcp`](#sl-mcp)
+* [`sl microservice [NAME]`](#sl-microservice-name)
+* [`sl scaffold [NAME]`](#sl-scaffold-name)
+* [`sl update`](#sl-update)
 
 ## `sl autocomplete [SHELL]`
 
@@ -127,14 +124,26 @@ _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v3.2.1
 
 ## `sl mcp`
 
-Command that runs an MCP server for the sourceloop CLI, this is not supposed to be run directly, but rather used by the MCP client to interact with the CLI commands.
+Command that runs an MCP server for the sourceloop CLI, this is not supposed to be run directly, but rather used by the MCP client to interact with the CLI commands. 
 
 ```
 USAGE
   $ sl mcp
 
 OPTIONS
   --help  show manual pages
+
+DESCRIPTION
+  Command that runs an MCP server for the sourceloop CLI, this is not supposed to be run directly, but rather used by 
+  the MCP client to interact with the CLI commands. 
+    You can use it using the following MCP server configuration:
+      ```json
+      "sourceloop": {
+        "command": "npx",
+        "args": ["@sourceloop/cli", "mcp"],
+        "timeout": 300
+      }
+      ```
 ```
 
 _See code: [src/commands/mcp.ts](https://github.com/sourcefuse/loopback4-microservice-catalog/blob/v10.0.0/src/commands/mcp.ts)_
@@ -223,5 +232,4 @@ OPTIONS
 ```
 
 _See code: [src/commands/update.ts](https://github.com/sourcefuse/loopback4-microservice-catalog/blob/v10.0.0/src/commands/update.ts)_
-
 <!-- commandsstop -->

packages/cli/src/commands/mcp.ts

@@ -36,8 +36,17 @@ export class Mcp extends Base<{}> {
       this.commands = [Cdk, Extension, Microservice, Scaffold, Update];
     }
   }
-  static readonly description =
-    'Command that runs an MCP server for the sourceloop CLI, this is not supposed to be run directly, but rather used by the MCP client to interact with the CLI commands.';
+  static readonly description = `
+  Command that runs an MCP server for the sourceloop CLI, this is not supposed to be run directly, but rather used by the MCP client to interact with the CLI commands. 
+  You can use it using the following MCP server configuration:
+    \`\`\`json
+    "sourceloop": {
+      "command": "npx",
+      "args": ["@sourceloop/cli", "mcp"],
+      "timeout": 300
+    }
+    \`\`\`
+    `;
 
   static readonly flags = {
     help: flags.boolean({
@@ -152,17 +161,20 @@ export class Mcp extends Base<{}> {
     switch (true) {
       case flag.type === 'boolean':
         option = z.boolean().optional();
+        description += ` (ask user for this value if not provided)`;
         option = option.default((flag.default as boolean) ?? false);
         break;
       case this._isOptionFlag(flag) && flag.options !== undefined: {
+        description += ` (ask user to provide an option if not provided when required, list the options as well)`;
         // typescript is not able to infer type
         const typedFlag = flag as IOptionFlag<T>;
         option = z.enum(typedFlag.options as [string, ...string[]]);
         description += ` (options: ${typedFlag.options?.join(', ')})`;
         break;
       }
       case this._isOptionFlag(flag) && flag.options === undefined:
-        option = z.string();
+        description += ` (ask user for this value if not provided)`;
+        option = z.string().optional();
         break;
       default:
         throw new Error(