@leanmcp/cli 0.4.0 → 0.4.1

package/README.md

@@ -1,316 +1,295 @@
-# @leanmcp/cli
-
-Command-line tool for creating LeanMCP projects with production-ready templates.
+<p align="center">
+  <img
+    src="https://raw.githubusercontent.com/LeanMCP/leanmcp-sdk/refs/heads/main/assets/logo.svg"
+    alt="LeanMCP Logo"
+    width="400"
+  />
+</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" />
+  </a>
+  <a href="https://www.npmjs.com/package/@leanmcp/cli">
+    <img src="https://img.shields.io/npm/dm/@leanmcp/cli" alt="npm downloads" />
+  </a>
+  <a href="https://docs.leanmcp.com/sdk/cli">
+    <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" />
+  </a>
+  <a href="https://x.com/LeanMcp">
+    <img src="https://img.shields.io/badge/@LeanMCP-f5f5f5?logo=x&logoColor=000000" />
+  </a>
+</p>
 
 ## Features
 
-- **Interactive setup** - Guided prompts for dependency installation and dev server
-- **Quick project scaffolding** - Create new MCP servers in seconds
-- **Complete setup** - Includes TypeScript, dependencies, and configuration
-- **Best practices** - Generated projects follow MCP standards
-- **Ready to run** - Start developing immediately with hot reload
-- **Example service** - Includes working examples to get started
-- **Pure ESM** - Modern ES modules with full TypeScript support
+- **Quick Scaffolding** — Create production-ready MCP servers in seconds
+- **Hot Reload Development** — `leanmcp dev` with UI component hot-reload
+- **Cloud Deployment** — Deploy to LeanMCP Cloud with custom subdomains
+- **Project Management** — List, view, and delete cloud projects
+- **Interactive Setup** — Guided prompts for dependencies and dev server
 
 ## Installation
 
 ```bash
-# npm 
 npm install -g @leanmcp/cli
-
-# GitHub Packages 
-npm install -g @leanmcp/cli --registry=https://npm.pkg.github.com
 ```
 
-Or use without installing:
+Or run without installing:
 ```bash
 npx @leanmcp/cli create my-mcp-server
 ```
 
-## Usage
-
-### Create a New Project
+## Commands Overview
 
 ```bash
-leanmcp create <project-name>
-```
-
-Or with npx:
-```bash
-npx @leanmcp/cli create my-mcp-server
+# Local development
+leanmcp create <name>     # Create a new project
+leanmcp add <service>     # Add a service to existing project
+leanmcp dev               # Start development server with hot-reload
+leanmcp build             # Build for production
+leanmcp start             # Start production server
+
+# Cloud commands
+leanmcp login             # Authenticate with LeanMCP Cloud
+leanmcp logout            # Remove API key
+leanmcp whoami            # Show login status
+leanmcp deploy <folder>   # Deploy to LeanMCP Cloud
+leanmcp projects list     # List your cloud projects
+leanmcp projects get <id> # Get project details
+leanmcp projects delete <id>  # Delete a project
 ```
 
-### Example
+---
 
-```bash
-$ leanmcp create my-sentiment-tool
-✔ Project my-sentiment-tool created!
-
-Success! Your MCP server is ready.
+## Local Development
 
-Next, navigate to your project:
-  cd my-sentiment-tool
+### create
 
-? Would you like to install dependencies now? (Y/n) Yes
-✔ Dependencies installed successfully!
-? Would you like to start the development server? (Y/n) Yes
+Create a new MCP server project:
 
-Starting development server...
+```bash
+leanmcp create my-sentiment-tool
+```
 
-> my-sentiment-tool@1.0.0 dev
-> tsx watch main.ts
+Interactive prompts will guide you through:
+1. Creating the project structure
+2. Installing dependencies (optional)
+3. Starting the dev server (optional)
 
-[HTTP][INFO] Starting LeanMCP HTTP Server...
-[HTTP][INFO] Server running on http://localhost:3001
-[HTTP][INFO] MCP endpoint: http://localhost:3001/mcp
+**Generated structure:**
+```
+my-mcp-server/
+├── main.ts              # Entry point with HTTP server
+├── package.json         # Dependencies and scripts
+├── tsconfig.json        # TypeScript configuration
+└── mcp/                 # Services directory
+    └── example/
+        └── index.ts     # Example service with tools
 ```
 
-### Add a New Service
+### add
 
-After creating a project, you can quickly add new services:
+Add a new service to an existing project:
 
 ```bash
-leanmcp add <service-name>
+cd my-mcp-server
+leanmcp add weather
 ```
 
-This command:
-- Creates a new service file in `mcp/<service-name>.ts`
-- Includes example Tool, Prompt, and Resource decorators
+This:
+- Creates `mcp/weather/index.ts` with example Tool, Prompt, and Resource
 - Automatically registers the service in `main.ts`
-- Includes schema validation examples
+- Includes `@SchemaConstraint` validation examples
+
+### dev
 
-**Example:**
+Start the development server with hot-reload:
 
 ```bash
-$ leanmcp add weather
-✔ Created new service: weather
-   File: mcp/weather.ts
-   Tool: greet
-   Prompt: welcomePrompt
-   Resource: getStatus
-
-Service automatically registered in main.ts!
+leanmcp dev
 ```
 
-The generated service includes:
-- **Tool** - `greet()`: A callable function with schema validation
-- **Prompt** - `welcomePrompt()`: A reusable prompt template
-- **Resource** - `getStatus()`: A data endpoint
+This command:
+- Scans for `@UIApp` components and builds them
+- Starts the HTTP server with `tsx watch`
+- Watches `mcp/` directory for changes
+- Automatically rebuilds UI components when modified
+- Hot-reloads when adding/removing `@UIApp` decorators
 
-You can then customize these to fit your needs.
+```bash
+$ leanmcp dev
 
-## Generated Project Structure
+LeanMCP Development Server
 
-```
-my-mcp-server/
-├── main.ts              # Entry point with HTTP server
-├── package.json         # Dependencies and scripts
-├── tsconfig.json        # TypeScript configuration
-└── mcp/                 # Services directory
-    └── example.ts       # Example service with tools
-```
+ℹ Found 2 @UIApp component(s)
+ℹ UI components built
 
-## Generated Files
-
-### main.ts
-Entry point that:
-- Loads environment variables
-- Creates MCP server instance
-- Registers services
-- Starts HTTP server with session management
-
-### mcp/example.ts
-Example service demonstrating:
-- `@Tool` decorator for callable functions
-- `@Resource` decorator for data sources
-- `@Prompt` decorator for prompt templates
-- Class-based schema validation with `@SchemaConstraint`
-- Input/output type safety
-
-### package.json
-Includes:
-- `@leanmcp/core` - Core MCP functionality
-- `@modelcontextprotocol/sdk` - Official MCP SDK
-- `express` - HTTP server
-- `tsx` - TypeScript execution with hot reload
-- All type definitions
-
-### tsconfig.json
-Configured with:
-- ESNext modules
-- Decorator support
-- Strict type checking
-- Source maps
+Starting development server...
 
-## NPM Scripts
+[HTTP][INFO] Server running on http://localhost:3001
+[HTTP][INFO] MCP endpoint: http://localhost:3001/mcp
+```
 
-Generated projects include:
+### build
+
+Build the project for production:
 
 ```bash
-npm run dev     # Start with hot reload (tsx watch)
-npm run build   # Build for production
-npm run start   # Run production build
-npm run clean   # Remove build artifacts
+leanmcp build
 ```
 
-## Development Workflow
+Compiles TypeScript and bundles UI components.
 
-### Interactive Setup (Recommended)
+### start
 
-The CLI provides an interactive setup experience:
+Start the production server:
 
 ```bash
-# Create project
-leanmcp create my-mcp-server
+leanmcp start
+```
 
-# The CLI will:
-# 1. Create project structure
-# 2. Ask if you want to install dependencies (Y/n)
-# 3. If yes, ask if you want to start dev server (Y/n)
-# 4. If yes, start server with hot reload
+Runs the compiled production build.
 
-# If you choose "No" to installation:
-cd my-mcp-server
-npm install
-npm run dev
-```
+---
 
-### Manual Setup
+## Cloud Commands
 
-If you prefer manual control:
+### login
 
-```bash
-# 1. Create project (answer "No" to prompts)
-leanmcp create my-mcp-server
+Authenticate with LeanMCP Cloud:
 
-# 2. Navigate to project
-cd my-mcp-server
+```bash
+leanmcp login
+```
 
-# 3. Install dependencies
-npm install
+Steps:
+1. Go to [ship.leanmcp.com/api-keys](https://ship.leanmcp.com/api-keys)
+2. Create an API key with "BUILD_AND_DEPLOY" scope
+3. Enter the key when prompted
 
-# 4. Start development server
-npm run dev
+### logout
 
-# 5. Server starts on http://localhost:3001
-# - Endpoint: http://localhost:3001/mcp
-# - Health check: http://localhost:3001/health
-# - Hot reload enabled
+Remove your API key:
 
-# 6. Edit files in mcp/ directory
-# Server automatically reloads on changes
+```bash
+leanmcp logout
 ```
 
-## Testing Your Server
+### whoami
+
+Check your current login status:
 
-Test with curl:
 ```bash
-# List available tools
-curl http://localhost:3001/mcp \
-  -X POST \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 1,
-    "method": "tools/list"
-  }'
-
-# Call a tool
-curl http://localhost:3001/mcp \
-  -X POST \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 1,
-    "method": "tools/call",
-    "params": {
-      "name": "calculate",
-      "arguments": {
-        "a": 10,
-        "b": 5,
-        "operation": "add"
-      }
-    }
-  }'
+leanmcp whoami
 ```
 
-## Customizing Generated Projects
+### deploy
 
-### Add New Services
+Deploy your MCP server to LeanMCP Cloud:
 
-**Quick Way (Recommended):**
+```bash
+leanmcp deploy .
+# Or specify a folder
+leanmcp deploy ./my-project
+```
 
-Use the `add` command to automatically generate and register a new service:
+Deployment process:
+1. Creates project (or updates existing)
+2. Packages and uploads code
+3. Builds container image
+4. Deploys to serverless Lambda
+5. Configures custom subdomain
 
 ```bash
-leanmcp add weather
-```
+$ leanmcp deploy .
 
-This creates `mcp/weather.ts` with example Tool, Prompt, and Resource decorators, and automatically registers it in `main.ts`.
+LeanMCP Deploy
 
-**Manual Way:**
+Generated project name: swift-coral-sunset
+Path: /path/to/my-project
 
-Create a new file in `mcp/`:
+? Subdomain for your deployment: my-api
+✔ Subdomain 'my-api' is available
 
-```typescript
-// mcp/weather.ts
-import { Tool } from "@leanmcp/core";
+? Proceed with deployment? Yes
 
-export class WeatherService {
-  @Tool({ description: 'Get weather for a city' })
-  async getWeather(input: { city: string }) {
-    // Your implementation
-    return { temperature: 72, condition: 'sunny' };
-  }
-}
-```
+✔ Project created: 7f4a3b2c...
+✔ Project uploaded
+✔ Build complete (45s)
+✔ Deployed
+✔ Subdomain configured
 
-Register in `main.ts`:
-```typescript
-import { WeatherService } from "./mcp/weather.js";
+============================================================
+  DEPLOYMENT SUCCESSFUL!
+============================================================
 
-server.registerService(new WeatherService());
-```
+  Your MCP server is now live:
 
-### Add Authentication
+  URL:  https://my-api.leanmcp.dev
 
-Install auth package:
-```bash
-npm install @leanmcp/auth
+  Test endpoints:
+    curl https://my-api.leanmcp.dev/health
+    curl https://my-api.leanmcp.dev/mcp
 ```
 
-See [@leanmcp/auth](../auth) documentation for details.
+### projects
 
-### Configure Port
+Manage your cloud projects:
 
-Set in environment variable:
 ```bash
-PORT=4000 npm run dev
+# List all projects
+leanmcp projects list
+
+# Get project details
+leanmcp projects get <project-id>
+
+# Delete a project
+leanmcp projects delete <project-id>
+leanmcp projects delete <project-id> --force  # Skip confirmation
 ```
 
-Or in `.env` file:
+---
+
+## NPM Scripts
+
+Generated projects include:
+
 ```bash
-PORT=4000
+npm run dev     # Start with hot reload (tsx watch)
+npm run build   # Build for production
+npm run start   # Run production build
+npm run clean   # Remove build artifacts
 ```
 
-## Advanced Options
+## Configuration
 
-### Custom Project Location
+### Port
 
 ```bash
-leanmcp create my-project
-cd my-project
+PORT=4000 npm run dev
+# Or in .env file
+PORT=4000
 ```
 
-Project is created in current directory with the specified name.
+### LeanMCP Config
 
-### Modify Template
-
-The generated project is fully customizable:
-- Edit `main.ts` for server configuration
-- Add/remove services in `mcp/` directory
-- Modify `package.json` for additional dependencies
-- Update `tsconfig.json` for compiler options
+Stored in `~/.leanmcp/config.json`:
+```json
+{
+  "apiKey": "airtrain_...",
+  "apiUrl": "https://api.leanmcp.com",
+  "lastUpdated": "2024-01-15T10:30:00.000Z"
+}
+```
 
 ## Troubleshooting
 
@@ -323,106 +302,52 @@ PORT=3002
 
 ### Module Not Found Errors
 
-Ensure you've installed dependencies:
+Ensure dependencies are installed:
 ```bash
 npm install
 ```
 
-### TypeScript Errors
-
-Check your `tsconfig.json` and ensure:
-- `experimentalDecorators: true`
-- `emitDecoratorMetadata: true`
+### TypeScript Decorator Errors
 
-### Hot Reload Not Working
-
-Try restarting the dev server:
-```bash
-npm run dev
+Ensure your `tsconfig.json` has:
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
 ```
 
-## Project Types
-
-Currently supports:
-- **MCP Server** - Standard MCP server with HTTP transport
+### Deploy: Not Logged In
 
-Coming soon:
-- MCP Server with Auth
-- MCP Server with Database
-- MCP Server with File Storage
+Run `leanmcp login` first to authenticate with your API key.
 
-## Examples
+### Deploy: Subdomain Taken
 
-See the [examples](../../examples) directory for complete working examples:
-- [basic-sentiment-tool](../../examples/basic-sentiment-tool) - Simple sentiment analysis
-- [slack-with-auth](../../examples/slack-with-auth) - Slack integration with Cognito auth
+Choose a different subdomain when prompted.
 
 ## Requirements
 
 - Node.js >= 18.0.0
 - npm >= 9.0.0
 
-## CLI Commands
-
-```bash
-leanmcp create <name>      # Create new project
-leanmcp add <service>      # Add new service to existing project
-leanmcp --version          # Show version
-leanmcp --help             # Show help
-```
-
-### Command Details
+## Documentation
 
-#### `create <project-name>`
-Creates a complete MCP server project with:
-- Entry point (`main.ts`)
-- Example service with Tool, Resource, and Prompt decorators
-- TypeScript configuration
-- Package.json with all dependencies
-- Development and build scripts
+- [Full Documentation](https://docs.leanmcp.com/sdk/cli)
 
-**Interactive Prompts:**
-- Asks if you want to install dependencies
-- If installed, asks if you want to start dev server
-- Runs commands in the project directory automatically
-
-#### `add <service-name>`
-Adds a new service to an existing project:
-- Must be run inside a LeanMCP project directory
-- Creates `mcp/<service-name>.ts` with template code
-- Automatically imports and registers in `main.ts`
-- Includes example Tool, Prompt, and Resource implementations
-- Uses schema validation with `@SchemaConstraint` decorators
-
-## 🌟 Showcase Your MCP Server
-
-Built something cool with LeanMCP? We'd love to feature it!
+## Related Packages
 
-### How to Get Featured
+- [@leanmcp/core](https://www.npmjs.com/package/@leanmcp/core) — Core MCP server functionality
+- [@leanmcp/auth](https://www.npmjs.com/package/@leanmcp/auth) — Authentication decorators
+- [@leanmcp/ui](https://www.npmjs.com/package/@leanmcp/ui) — MCP App UI components
 
-1. **Build** an awesome MCP server using LeanMCP
-2. **Share** your project on GitHub
-3. **Submit** for showcase:
-   - Open an issue: [Request Showcase](https://github.com/LeanMCP/leanmcp-sdk/issues/new?title=[Showcase]%20Your%20Project%20Name)
-   - Include:
-     - Project name and description
-     - GitHub repository link
-     - What makes it unique
-     - Screenshots or demo 
+## 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
 
 MIT
-
-## Related Packages
-
-- [@leanmcp/core](../core) - Core MCP server functionality
-- [@leanmcp/auth](../auth) - Authentication decorators
-- [@leanmcp/utils](../utils) - Utility functions
-
-## Links
-
-- [GitHub Repository](https://github.com/LeanMCP/leanmcp-sdk)
-- [Documentation](https://github.com/LeanMCP/leanmcp-sdk#readme)
-- [MCP Specification](https://spec.modelcontextprotocol.io/)

package/dist/index.js

@@ -150,6 +150,8 @@ __name(parseImports, "parseImports");
 import * as vite from "vite";
 import react from "@vitejs/plugin-react";
 import { viteSingleFile } from "vite-plugin-singlefile";
+import tailwindcss from "tailwindcss";
+import autoprefixer from "autoprefixer";
 import fs2 from "fs-extra";
 import path2 from "path";
 function resolveReactDependency(startDir, packageName) {
@@ -406,10 +408,10 @@ createRoot(document.getElementById('root')!).render(
       css: {
         postcss: {
           plugins: [
-            (await import("tailwindcss")).default({
+            tailwindcss({
               config: tailwindConfig
             }),
-            (await import("autoprefixer")).default
+            autoprefixer
           ]
         }
       },
@@ -418,6 +420,8 @@ createRoot(document.getElementById('root')!).render(
         emptyOutDir: false,
         sourcemap: isDev ? "inline" : false,
         minify: !isDev,
+        // Force cache invalidation between builds to reduce memory accumulation
+        watch: null,
         rollupOptions: {
           input: entryHtml,
           output: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanmcp/cli",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Command-line interface for scaffolding LeanMCP projects",
   "bin": {
     "leanmcp": "bin/leanmcp.js"