@leanmcp/cli 0.5.5-alpha.38.4ae4dde → 0.5.5-alpha.42.6df6bbe

package/README.md

@@ -1,3 +1,5 @@
+# @leanmcp/cli
+
 <p align="center">
   <img
     src="https://raw.githubusercontent.com/LeanMCP/leanmcp-sdk/refs/heads/main/assets/logo.png"
@@ -6,11 +8,6 @@
   />
 </p>
 
-<p align="center">
-  <strong>@leanmcp/cli</strong><br/>
-  Command-line tool for creating, developing, and deploying LeanMCP projects.
-</p>
-
 <p align="center">
   <a href="https://www.npmjs.com/package/@leanmcp/cli">
     <img src="https://img.shields.io/npm/v/@leanmcp/cli" alt="npm version" />
@@ -22,7 +19,7 @@
     <img src="https://img.shields.io/badge/Docs-leanmcp-0A66C2?" />
   </a>
   <a href="https://discord.com/invite/DsRcA3GwPy">
-    <img src="https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white" />
+    <img src="https://dcbadge.limes.pink/api/server/DsRcA3GwPy?style=flat" alt="Discord" />
   </a>
   <a href="https://x.com/LeanMcp">
     <img src="https://img.shields.io/badge/@LeanMCP-f5f5f5?logo=x&logoColor=000000" />
@@ -33,6 +30,58 @@
   <a href="https://deepwiki.com/LeanMCP/leanmcp-sdk"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
+```json
+{
+  "package": "@leanmcp/cli",
+  "purpose": "Command-line interface for scaffolding LeanMCP projects",
+  "useCases": [
+    "Project scaffolding",
+    "Local development with hot-reload",
+    "Cloud deployment",
+    "Project management"
+  ],
+  "dependencies": ["@inquirer/prompts", "commander", "chalk", "vite", "archiver", "fs-extra"],
+  "bin": {
+    "leanmcp": "bin/leanmcp.js"
+  },
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  }
+}
+```
+
+## Overview
+
+- **What it is**: Command-line interface for scaffolding LeanMCP projects with hot-reload development and cloud deployment
+- **Purpose**: Streamlines the entire MCP server development workflow from project creation to production deployment
+- **Key benefits**:
+  - Quick project scaffolding with production-ready templates
+  - Hot-reload development server with UI component building
+  - One-command cloud deployment to LeanMCP platform
+  - Interactive setup with guided prompts
+  - Project management and monitoring tools
+
+## When to Use It
+
+**Use `@leanmcp/cli` when:**
+
+- Starting any new MCP server project (highly recommended)
+- Need local development with hot-reload and UI building
+- Want to deploy to LeanMCP Cloud with custom subdomains
+- Managing multiple MCP projects
+- Need guided setup for dependencies and configuration
+
+**You probably do NOT need this if:**
+
+- Using custom build systems or deployment pipelines
+- Only working with existing projects without scaffolding needs
+- Building MCP clients (not servers)
+- Working in environments where global CLI tools aren't allowed
+
 ## Features
 
 - **Quick Scaffolding** — Create production-ready MCP servers in seconds
@@ -53,7 +102,14 @@ Or run without installing:
 npx @leanmcp/cli create my-mcp-server
 ```
 
-## Commands Overview
+**Requirements:**
+
+- Node.js >= 18.0.0
+- npm >= 9.0.0
+
+## Usage / Examples
+
+### Commands Overview
 
 ```bash
 # Local development
@@ -270,7 +326,60 @@ leanmcp projects delete <project-id> --force  # Skip confirmation
 
 ---
 
-## NPM Scripts
+## API Reference
+
+### Command Reference
+
+| Command                | Description                              | Usage                          |
+| ---------------------- | ---------------------------------------- | ------------------------------ |
+| `create <name>`        | Create new MCP server project            | `leanmcp create my-server`     |
+| `add <service>`        | Add service to existing project          | `leanmcp add weather`          |
+| `dev`                  | Start development server with hot-reload | `leanmcp dev`                  |
+| `build`                | Build for production                     | `leanmcp build`                |
+| `start`                | Start production server                  | `leanmcp start`                |
+| `login`                | Authenticate with LeanMCP Cloud          | `leanmcp login`                |
+| `logout`               | Remove API key                           | `leanmcp logout`               |
+| `whoami`               | Show login status                        | `leanmcp whoami`               |
+| `deploy [folder]`      | Deploy to LeanMCP Cloud                  | `leanmcp deploy .`             |
+| `projects list`        | List cloud projects                      | `leanmcp projects list`        |
+| `projects get <id>`    | Get project details                      | `leanmcp projects get <id>`    |
+| `projects delete <id>` | Delete project                           | `leanmcp projects delete <id>` |
+| `env list [folder]`    | List environment variables               | `leanmcp env list`             |
+| `env set <keyValue>`   | Set environment variable                 | `leanmcp env set KEY=VALUE`    |
+| `env get <key>`        | Get environment variable value           | `leanmcp env get KEY`          |
+| `env remove <key>`     | Remove environment variable              | `leanmcp env remove KEY`       |
+| `env pull [folder]`    | Download env vars to local file          | `leanmcp env pull`             |
+| `env push [folder]`    | Upload env vars from local file          | `leanmcp env push`             |
+
+---
+
+## Integration with Other LeanMCP Packages
+
+**@leanmcp/cli** works seamlessly with all LeanMCP packages:
+
+- **[@leanmcp/core](https://www.npmjs.com/package/@leanmcp/core)** — Generated projects use `@leanmcp/core` as the foundation
+- **[@leanmcp/auth](https://www.npmjs.com/package/@leanmcp/auth)** — CLI can scaffold projects with authentication setup
+- **[@leanmcp/ui](https://www.npmjs.com/package/@leanmcp/ui)** — `leanmcp dev` automatically builds UI components with hot-reload
+- **[@leanmcp/elicitation](https://www.npmjs.com/package/@leanmcp/elicitation)** — Generated services include elicitation examples
+- **[@leanmcp/env-injection](https://www.npmjs.com/package/@leanmcp/env-injection)** — Deploy command handles user secrets configuration
+
+**Generated project structure:**
+
+```
+my-mcp-server/
+├── main.ts              # Entry point with HTTP server
+├── package.json         # Dependencies and scripts
+├── tsconfig.json        # TypeScript configuration
+└── mcp/                 # Services directory (auto-discovered)
+    └── example/
+        └── index.ts     # Example service with @Tool, @Prompt, @Resource
+```
+
+---
+
+## Best Practices / Troubleshooting
+
+### NPM Scripts
 
 Generated projects include:
 
@@ -357,12 +466,12 @@ Choose a different subdomain when prompted.
 - [@leanmcp/auth](https://www.npmjs.com/package/@leanmcp/auth) — Authentication decorators
 - [@leanmcp/ui](https://www.npmjs.com/package/@leanmcp/ui) — MCP App UI components
 
-## Links
-
-- [GitHub Repository](https://github.com/LeanMCP/leanmcp-sdk)
-- [NPM Package](https://www.npmjs.com/package/@leanmcp/cli)
-- [LeanMCP Dashboard](https://ship.leanmcp.com)
+---
 
-## License
+## Links
 
-MIT
+- **Documentation**: [https://docs.leanmcp.com/sdk/cli](https://docs.leanmcp.com/sdk/cli)
+- **GitHub**: [https://github.com/LeanMCP/leanmcp-sdk/tree/main/packages/cli](https://github.com/LeanMCP/leanmcp-sdk/tree/main/packages/cli)
+- **npm**: [https://www.npmjs.com/package/@leanmcp/cli](https://www.npmjs.com/package/@leanmcp/cli)
+- **LeanMCP Dashboard**: [https://ship.leanmcp.com](https://ship.leanmcp.com)
+- **License**: MIT

package/dist/index.js

@@ -1786,6 +1786,42 @@ async function debugFetch(url, options = {}) {
   return response;
 }
 __name(debugFetch, "debugFetch");
+async function fetchWithRetry(fetchFn, options = {}) {
+  const maxRetries = options.maxRetries ?? 15;
+  const initialDelay = options.initialDelay ?? 1e3;
+  const maxDelay = options.maxDelay ?? 1e4;
+  const operation = options.operation ?? "Fetch";
+  const spinner = options.spinner;
+  const retryOnHttpErrors = options.retryOnHttpErrors ?? false;
+  let lastError = null;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      const response = await fetchFn();
+      if (retryOnHttpErrors && !response.ok && response.status >= 500) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      }
+      return response;
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+      if (attempt < maxRetries) {
+        const delay = Math.min(initialDelay * Math.pow(2, attempt), maxDelay);
+        const message = `${operation} failed. Retrying... (${attempt + 1}/${maxRetries})`;
+        if (spinner) {
+          spinner.text = message;
+        } else {
+          process.stdout.write("\r" + chalk.yellow(message));
+        }
+        debug3(`Retry ${attempt + 1}/${maxRetries}: ${lastError.message}, waiting ${delay}ms`);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+    }
+  }
+  if (!spinner) {
+    process.stdout.write("\x1B[2K\r");
+  }
+  throw new Error(`${operation} failed after ${maxRetries + 1} attempts (1 initial + ${maxRetries} retries): ${lastError?.message || "Unknown error"}`);
+}
+__name(fetchWithRetry, "fetchWithRetry");
 var API_ENDPOINTS = {
   // Projects
   projects: "/api/projects",
@@ -1872,10 +1908,14 @@ async function waitForBuild(apiUrl, apiKey, buildId, spinner) {
   const maxAttempts = 60;
   let attempts = 0;
   while (attempts < maxAttempts) {
-    const response = await debugFetch(`${apiUrl}${API_ENDPOINTS.getBuild}/${buildId}`, {
+    const response = await fetchWithRetry(() => debugFetch(`${apiUrl}${API_ENDPOINTS.getBuild}/${buildId}`, {
       headers: {
         Authorization: `Bearer ${apiKey}`
       }
+    }), {
+      operation: "Build status check",
+      spinner,
+      maxRetries: 3
     });
     if (!response.ok) {
       throw new Error(`Failed to get build status: ${response.statusText}`);
@@ -1901,10 +1941,14 @@ async function waitForDeployment(apiUrl, apiKey, deploymentId, spinner) {
   const maxAttempts = 60;
   let attempts = 0;
   while (attempts < maxAttempts) {
-    const response = await debugFetch(`${apiUrl}${API_ENDPOINTS.getDeployment}/${deploymentId}`, {
+    const response = await fetchWithRetry(() => debugFetch(`${apiUrl}${API_ENDPOINTS.getDeployment}/${deploymentId}`, {
       headers: {
         Authorization: `Bearer ${apiKey}`
       }
+    }), {
+      operation: "Deployment status check",
+      spinner,
+      maxRetries: 3
     });
     if (!response.ok) {
       throw new Error(`Failed to get deployment status: ${response.statusText}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanmcp/cli",
-  "version": "0.5.5-alpha.38.4ae4dde",
+  "version": "0.5.5-alpha.42.6df6bbe",
   "description": "Command-line interface for scaffolding LeanMCP projects",
   "bin": {
     "leanmcp": "bin/leanmcp.js"