@leanmcp/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 LeanMCP Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,367 @@
+# @leanmcp/cli
+
+Command-line tool for creating LeanMCP projects with production-ready templates.
+
+## Features
+
+- **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
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @leanmcp/cli
+```
+
+### Run Without Installing
+
+```bash
+npx @leanmcp/cli create my-mcp-server
+```
+
+## Usage
+
+### Create a New Project
+
+```bash
+leanmcp create <project-name>
+```
+
+Or with npx:
+```bash
+npx @leanmcp/cli create my-mcp-server
+```
+
+### Example
+
+```bash
+$ leanmcp create my-sentiment-tool
+✔ Creating project my-sentiment-tool...
+
+Project created successfully!
+
+Next steps:
+  cd my-sentiment-tool
+  npm install
+  npm run dev
+
+Your MCP server will be running on http://localhost:3001
+```
+
+### Add a New Service
+
+After creating a project, you can quickly add new services:
+
+```bash
+leanmcp add <service-name>
+```
+
+This command:
+- Creates a new service file in `mcp/<service-name>.ts`
+- Includes example Tool, Prompt, and Resource decorators
+- Automatically registers the service in `main.ts`
+- Includes schema validation examples
+
+**Example:**
+
+```bash
+$ leanmcp add weather
+✔ Created new service: weather
+   File: mcp/weather.ts
+   Tool: greet
+   Prompt: welcomePrompt
+   Resource: getStatus
+
+Service automatically registered in main.ts!
+```
+
+The generated service includes:
+- **Tool** - `greet()`: A callable function with schema validation
+- **Prompt** - `welcomePrompt()`: A reusable prompt template
+- **Resource** - `getStatus()`: A data endpoint
+
+You can then customize these to fit your needs.
+
+## 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
+    └── example.ts       # Example service with tools
+```
+
+## 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
+
+## NPM Scripts
+
+Generated projects include:
+
+```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
+```
+
+## Development Workflow
+
+After creating a project:
+
+```bash
+# 1. Install dependencies
+cd my-mcp-server
+npm install
+
+# 2. Start development server
+npm run dev
+
+# 3. Server starts on http://localhost:3001
+# - Endpoint: http://localhost:3001/mcp
+# - Health check: http://localhost:3001/health
+# - Hot reload enabled
+
+# 4. Edit files in mcp/ directory
+# Server automatically reloads on changes
+```
+
+## Testing Your Server
+
+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"
+      }
+    }
+  }'
+```
+
+## Customizing Generated Projects
+
+### Add New Services
+
+**Quick Way (Recommended):**
+
+Use the `add` command to automatically generate and register a new service:
+
+```bash
+leanmcp add weather
+```
+
+This creates `mcp/weather.ts` with example Tool, Prompt, and Resource decorators, and automatically registers it in `main.ts`.
+
+**Manual Way:**
+
+Create a new file in `mcp/`:
+
+```typescript
+// mcp/weather.ts
+import { Tool } from "@leanmcp/core";
+
+export class WeatherService {
+  @Tool({ description: 'Get weather for a city' })
+  async getWeather(input: { city: string }) {
+    // Your implementation
+    return { temperature: 72, condition: 'sunny' };
+  }
+}
+```
+
+Register in `main.ts`:
+```typescript
+import { WeatherService } from "./mcp/weather.js";
+
+server.registerService(new WeatherService());
+```
+
+### Add Authentication
+
+Install auth package:
+```bash
+npm install @leanmcp/auth
+```
+
+See [@leanmcp/auth](../auth) documentation for details.
+
+### Configure Port
+
+Set in environment variable:
+```bash
+PORT=4000 npm run dev
+```
+
+Or in `.env` file:
+```bash
+PORT=4000
+```
+
+## Advanced Options
+
+### Custom Project Location
+
+```bash
+leanmcp create my-project
+cd my-project
+```
+
+Project is created in current directory with the specified name.
+
+### 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
+
+## Troubleshooting
+
+### Port Already in Use
+
+Change the port in `.env`:
+```bash
+PORT=3002
+```
+
+### Module Not Found Errors
+
+Ensure you've installed dependencies:
+```bash
+npm install
+```
+
+### TypeScript Errors
+
+Check your `tsconfig.json` and ensure:
+- `experimentalDecorators: true`
+- `emitDecoratorMetadata: true`
+
+### Hot Reload Not Working
+
+Try restarting the dev server:
+```bash
+npm run dev
+```
+
+## Project Types
+
+Currently supports:
+- **MCP Server** - Standard MCP server with HTTP transport
+
+Coming soon:
+- MCP Server with Auth
+- MCP Server with Database
+- MCP Server with File Storage
+
+## Examples
+
+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
+
+## 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
+
+#### `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
+
+#### `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
+
+## 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.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,440 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_commander = require("commander");
+var import_chalk = __toESM(require("chalk"));
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_path = __toESM(require("path"));
+var import_ora = __toESM(require("ora"));
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+__name(capitalize, "capitalize");
+var program = new import_commander.Command();
+program.name("leanmcp").description("LeanMCP CLI \u2014 create production-ready MCP servers with Streamable HTTP").version("0.1.0");
+program.command("create <projectName>").description("Create a new LeanMCP project with Streamable HTTP transport").action(async (projectName) => {
+  const spinner = (0, import_ora.default)(`Creating project ${projectName}...`).start();
+  const targetDir = import_path.default.join(process.cwd(), projectName);
+  if (import_fs_extra.default.existsSync(targetDir)) {
+    spinner.fail(`Folder ${projectName} already exists.`);
+    process.exit(1);
+  }
+  await import_fs_extra.default.mkdirp(targetDir);
+  await import_fs_extra.default.mkdirp(import_path.default.join(targetDir, "mcp"));
+  const pkg = {
+    name: projectName,
+    version: "1.0.0",
+    description: "MCP Server with Streamable HTTP Transport and LeanMCP SDK",
+    main: "dist/main.js",
+    type: "module",
+    scripts: {
+      dev: "tsx watch main.ts",
+      build: "tsc",
+      start: "node dist/main.js",
+      clean: "rm -rf dist"
+    },
+    keywords: [
+      "mcp",
+      "model-context-protocol",
+      "streamable-http",
+      "leanmcp"
+    ],
+    author: "",
+    license: "MIT",
+    dependencies: {
+      "@leanmcp/core": "^0.1.0",
+      "@modelcontextprotocol/sdk": "^1.0.0",
+      "cors": "^2.8.5",
+      "dotenv": "^16.5.0",
+      "express": "^5.1.0"
+    },
+    devDependencies: {
+      "@types/cors": "^2.8.19",
+      "@types/express": "^5.0.3",
+      "@types/node": "^20.0.0",
+      "tsx": "^4.20.3",
+      "typescript": "^5.6.3"
+    }
+  };
+  await import_fs_extra.default.writeJSON(import_path.default.join(targetDir, "package.json"), pkg, {
+    spaces: 2
+  });
+  const tsconfig = {
+    compilerOptions: {
+      module: "ESNext",
+      target: "ES2022",
+      moduleResolution: "Node",
+      esModuleInterop: true,
+      strict: true,
+      skipLibCheck: true,
+      outDir: "dist",
+      experimentalDecorators: true,
+      emitDecoratorMetadata: true
+    },
+    include: [
+      "**/*.ts"
+    ],
+    exclude: [
+      "node_modules",
+      "dist"
+    ]
+  };
+  await import_fs_extra.default.writeJSON(import_path.default.join(targetDir, "tsconfig.json"), tsconfig, {
+    spaces: 2
+  });
+  const mainTs = `import dotenv from "dotenv";
+import { createHTTPServer, MCPServer } from "@leanmcp/core";
+import { ExampleService } from "./mcp/example.js";
+
+// Load environment variables
+dotenv.config();
+
+const PORT = Number(process.env.PORT) || 3001;
+
+/**
+ * Create and configure the MCP server
+ */
+function createMCPServer() {
+  const server = new MCPServer({ 
+    name: "${projectName}", 
+    version: "1.0.0" 
+  });
+
+  // Register your services here
+  server.registerService(new ExampleService());
+
+  return server.getServer();
+}
+
+// Start the HTTP server
+await createHTTPServer(createMCPServer, {
+  port: PORT,
+  cors: true,
+  logging: true
+});
+`;
+  await import_fs_extra.default.writeFile(import_path.default.join(targetDir, "main.ts"), mainTs);
+  const exampleServiceTs = `import { Tool, Resource, Prompt, SchemaConstraint, Optional } from "@leanmcp/core";
+
+/**
+ * Example service demonstrating LeanMCP SDK decorators
+ * 
+ * This is a simple example to get you started. Add your own tools, resources, and prompts here!
+ */
+
+// Input schema with validation decorators
+class CalculateInput {
+  @SchemaConstraint({ description: "First number" })
+  a!: number;
+
+  @SchemaConstraint({ description: "Second number" })
+  b!: number;
+
+  @Optional()
+  @SchemaConstraint({ 
+    description: "Operation to perform",
+    enum: ["add", "subtract", "multiply", "divide"],
+    default: "add"
+  })
+  operation?: string;
+}
+
+export class ExampleService {
+  @Tool({ 
+    description: "Perform arithmetic operations with automatic schema validation",
+    inputClass: CalculateInput
+  })
+  async calculate(input: CalculateInput) {
+    let result: number;
+    
+    switch (input.operation || "add") {
+      case "add":
+        result = input.a + input.b;
+        break;
+      case "subtract":
+        result = input.a - input.b;
+        break;
+      case "multiply":
+        result = input.a * input.b;
+        break;
+      case "divide":
+        if (input.b === 0) throw new Error("Cannot divide by zero");
+        result = input.a / input.b;
+        break;
+      default:
+        throw new Error("Invalid operation");
+    }
+
+    return {
+      content: [{
+        type: "text" as const,
+        text: JSON.stringify({
+          operation: input.operation || "add",
+          operands: { a: input.a, b: input.b },
+          result
+        }, null, 2)
+      }]
+    };
+  }
+
+  @Tool({ description: "Echo a message back" })
+  async echo(input: { message: string }) {
+    return {
+      content: [{
+        type: "text" as const,
+        text: JSON.stringify({
+          echoed: input.message,
+          timestamp: new Date().toISOString()
+        }, null, 2)
+      }]
+    };
+  }
+
+  @Resource({ description: "Get server information" })
+  async serverInfo() {
+    return {
+      contents: [{
+        uri: "server://info",
+        mimeType: "application/json",
+        text: JSON.stringify({
+          name: "${projectName}",
+          version: "1.0.0",
+          uptime: process.uptime()
+        }, null, 2)
+      }]
+    };
+  }
+
+  @Prompt({ description: "Generate a greeting prompt" })
+  async greeting(args: { name?: string }) {
+    return {
+      messages: [{
+        role: "user" as const,
+        content: {
+          type: "text" as const,
+          text: \`Hello \${args.name || 'there'}! Welcome to ${projectName}.\`
+        }
+      }]
+    };
+  }
+}
+`;
+  await import_fs_extra.default.writeFile(import_path.default.join(targetDir, "mcp", "example.ts"), exampleServiceTs);
+  const gitignore = `node_modules
+dist
+.env
+.env.local
+*.log
+`;
+  const env = `# Server Configuration
+PORT=3001
+NODE_ENV=development
+
+# Add your environment variables here
+`;
+  await import_fs_extra.default.writeFile(import_path.default.join(targetDir, ".gitignore"), gitignore);
+  await import_fs_extra.default.writeFile(import_path.default.join(targetDir, ".env"), env);
+  const readme = `# ${projectName}
+
+MCP Server with Streamable HTTP Transport built with LeanMCP SDK
+
+## Quick Start
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Start development server (hot reload)
+npm run dev
+
+# Build for production
+npm run build
+
+# Run production server
+npm start
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${projectName}/
+\u251C\u2500\u2500 main.ts              # Server entry point
+\u251C\u2500\u2500 mcp/
+\u2502   \u2514\u2500\u2500 example.ts       # Example service
+\u251C\u2500\u2500 .env                 # Environment variables
+\u2514\u2500\u2500 package.json
+\`\`\`
+
+## Adding New Services
+
+Create a new service file in \`mcp/\`:
+
+\`\`\`typescript
+import { Tool } from "@leanmcp/core";
+
+export class MyService {
+  @Tool({ description: "My awesome tool" })
+  async myTool(input: { message: string }) {
+    return {
+      content: [{
+        type: "text",
+        text: \`You said: \${input.message}\`
+      }]
+    };
+  }
+}
+\`\`\`
+
+Then register it in \`main.ts\`:
+
+\`\`\`typescript
+import { MyService } from "./mcp/my-service.js";
+server.registerService(new MyService());
+\`\`\`
+
+## Testing with MCP Inspector
+
+\`\`\`bash
+npx @modelcontextprotocol/inspector http://localhost:3001/mcp
+\`\`\`
+
+## License
+
+MIT
+`;
+  await import_fs_extra.default.writeFile(import_path.default.join(targetDir, "README.md"), readme);
+  spinner.succeed(`Project ${projectName} created!`);
+  console.log(import_chalk.default.green("\\nSuccess! Your MCP server is ready.\\n"));
+  console.log(import_chalk.default.cyan("Next steps:"));
+  console.log(import_chalk.default.gray(`  cd ${projectName}`));
+  console.log(import_chalk.default.gray(`  npm install`));
+  console.log(import_chalk.default.gray(`  npm run dev`));
+  console.log(import_chalk.default.gray(`\\nServer will run on http://localhost:3001`));
+});
+program.command("add <serviceName>").description("Add a new MCP service to your project").action(async (serviceName) => {
+  const cwd = process.cwd();
+  const mcpDir = import_path.default.join(cwd, "mcp");
+  if (!import_fs_extra.default.existsSync(import_path.default.join(cwd, "main.ts"))) {
+    console.error(import_chalk.default.red("ERROR: Not a LeanMCP project (main.ts missing)."));
+    process.exit(1);
+  }
+  await import_fs_extra.default.mkdirp(mcpDir);
+  const serviceFile = import_path.default.join(mcpDir, `${serviceName}.ts`);
+  if (import_fs_extra.default.existsSync(serviceFile)) {
+    console.error(import_chalk.default.red(`ERROR: Service ${serviceName} already exists.`));
+    process.exit(1);
+  }
+  const indexTs = `import { Tool, Resource, Prompt, Optional, SchemaConstraint } from "@leanmcp/core";
+
+// Input schema for greeting
+class GreetInput {
+  @SchemaConstraint({
+    description: "Name to greet",
+    minLength: 1
+  })
+  name!: string;
+}
+
+/**
+ * ${capitalize(serviceName)} Service
+ * 
+ * This service demonstrates the three types of MCP primitives:
+ * - Tools: Callable functions (like API endpoints)
+ * - Prompts: Reusable prompt templates
+ * - Resources: Data sources/endpoints
+ */
+export class ${capitalize(serviceName)}Service {
+  // TOOL - Callable function
+  // Tool name: "greet" (from function name)
+  @Tool({ 
+    description: "Greet a user by name",
+    inputClass: GreetInput
+  })
+  greet(args: GreetInput) {
+    return { message: \`Hello, \${args.name}! from ${serviceName}\` };
+  }
+
+  // PROMPT - Prompt template
+  // Prompt name: "welcomePrompt" (from function name)
+  @Prompt({ description: "Welcome message prompt template" })
+  welcomePrompt(args: { userName?: string }) {
+    return {
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: \`Welcome \${args.userName || 'user'}! How can I help you with ${serviceName}?\`
+          }
+        }
+      ]
+    };
+  }
+
+  // RESOURCE - Data endpoint
+  // Resource URI auto-generated from class and method name
+  @Resource({ description: "${capitalize(serviceName)} service status" })
+  getStatus() {
+    return { 
+      service: "${serviceName}", 
+      status: "active",
+      timestamp: new Date().toISOString()
+    };
+  }
+}
+`;
+  await import_fs_extra.default.writeFile(serviceFile, indexTs);
+  const mainTsPath = import_path.default.join(cwd, "main.ts");
+  let mainTsContent = await import_fs_extra.default.readFile(mainTsPath, "utf-8");
+  const serviceClassName = `${capitalize(serviceName)}Service`;
+  const importStatement = `import { ${serviceClassName} } from "./mcp/${serviceName}.js";`;
+  const registerStatement = `  server.registerService(new ${serviceClassName}());`;
+  const lastImportMatch = mainTsContent.match(/import .* from .*;\n/g);
+  if (lastImportMatch) {
+    const lastImport = lastImportMatch[lastImportMatch.length - 1];
+    const lastImportIndex = mainTsContent.lastIndexOf(lastImport);
+    const afterLastImport = lastImportIndex + lastImport.length;
+    mainTsContent = mainTsContent.slice(0, afterLastImport) + importStatement + "\n" + mainTsContent.slice(afterLastImport);
+  }
+  const registerPattern = /server\.registerService\(new \w+\(\)\);/g;
+  const matches = [
+    ...mainTsContent.matchAll(registerPattern)
+  ];
+  if (matches.length > 0) {
+    const lastMatch = matches[matches.length - 1];
+    const insertPosition = lastMatch.index + lastMatch[0].length;
+    mainTsContent = mainTsContent.slice(0, insertPosition) + "\n" + registerStatement + mainTsContent.slice(insertPosition);
+  }
+  await import_fs_extra.default.writeFile(mainTsPath, mainTsContent);
+  console.log(import_chalk.default.green(`\\nCreated new service: ${import_chalk.default.bold(serviceName)}`));
+  console.log(import_chalk.default.gray(`   File: mcp/${serviceName}.ts`));
+  console.log(import_chalk.default.gray(`   Tool: greet`));
+  console.log(import_chalk.default.gray(`   Prompt: welcomePrompt`));
+  console.log(import_chalk.default.gray(`   Resource: getStatus`));
+  console.log(import_chalk.default.green(`\\nService automatically registered in main.ts!`));
+});
+program.parse();

package/dist/index.mjs

@@ -0,0 +1,418 @@
+#!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/index.ts
+import { Command } from "commander";
+import chalk from "chalk";
+import fs from "fs-extra";
+import path from "path";
+import ora from "ora";
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+__name(capitalize, "capitalize");
+var program = new Command();
+program.name("leanmcp").description("LeanMCP CLI \u2014 create production-ready MCP servers with Streamable HTTP").version("0.1.0");
+program.command("create <projectName>").description("Create a new LeanMCP project with Streamable HTTP transport").action(async (projectName) => {
+  const spinner = ora(`Creating project ${projectName}...`).start();
+  const targetDir = path.join(process.cwd(), projectName);
+  if (fs.existsSync(targetDir)) {
+    spinner.fail(`Folder ${projectName} already exists.`);
+    process.exit(1);
+  }
+  await fs.mkdirp(targetDir);
+  await fs.mkdirp(path.join(targetDir, "mcp"));
+  const pkg = {
+    name: projectName,
+    version: "1.0.0",
+    description: "MCP Server with Streamable HTTP Transport and LeanMCP SDK",
+    main: "dist/main.js",
+    type: "module",
+    scripts: {
+      dev: "tsx watch main.ts",
+      build: "tsc",
+      start: "node dist/main.js",
+      clean: "rm -rf dist"
+    },
+    keywords: [
+      "mcp",
+      "model-context-protocol",
+      "streamable-http",
+      "leanmcp"
+    ],
+    author: "",
+    license: "MIT",
+    dependencies: {
+      "@leanmcp/core": "^0.1.0",
+      "@modelcontextprotocol/sdk": "^1.0.0",
+      "cors": "^2.8.5",
+      "dotenv": "^16.5.0",
+      "express": "^5.1.0"
+    },
+    devDependencies: {
+      "@types/cors": "^2.8.19",
+      "@types/express": "^5.0.3",
+      "@types/node": "^20.0.0",
+      "tsx": "^4.20.3",
+      "typescript": "^5.6.3"
+    }
+  };
+  await fs.writeJSON(path.join(targetDir, "package.json"), pkg, {
+    spaces: 2
+  });
+  const tsconfig = {
+    compilerOptions: {
+      module: "ESNext",
+      target: "ES2022",
+      moduleResolution: "Node",
+      esModuleInterop: true,
+      strict: true,
+      skipLibCheck: true,
+      outDir: "dist",
+      experimentalDecorators: true,
+      emitDecoratorMetadata: true
+    },
+    include: [
+      "**/*.ts"
+    ],
+    exclude: [
+      "node_modules",
+      "dist"
+    ]
+  };
+  await fs.writeJSON(path.join(targetDir, "tsconfig.json"), tsconfig, {
+    spaces: 2
+  });
+  const mainTs = `import dotenv from "dotenv";
+import { createHTTPServer, MCPServer } from "@leanmcp/core";
+import { ExampleService } from "./mcp/example.js";
+
+// Load environment variables
+dotenv.config();
+
+const PORT = Number(process.env.PORT) || 3001;
+
+/**
+ * Create and configure the MCP server
+ */
+function createMCPServer() {
+  const server = new MCPServer({ 
+    name: "${projectName}", 
+    version: "1.0.0" 
+  });
+
+  // Register your services here
+  server.registerService(new ExampleService());
+
+  return server.getServer();
+}
+
+// Start the HTTP server
+await createHTTPServer(createMCPServer, {
+  port: PORT,
+  cors: true,
+  logging: true
+});
+`;
+  await fs.writeFile(path.join(targetDir, "main.ts"), mainTs);
+  const exampleServiceTs = `import { Tool, Resource, Prompt, SchemaConstraint, Optional } from "@leanmcp/core";
+
+/**
+ * Example service demonstrating LeanMCP SDK decorators
+ * 
+ * This is a simple example to get you started. Add your own tools, resources, and prompts here!
+ */
+
+// Input schema with validation decorators
+class CalculateInput {
+  @SchemaConstraint({ description: "First number" })
+  a!: number;
+
+  @SchemaConstraint({ description: "Second number" })
+  b!: number;
+
+  @Optional()
+  @SchemaConstraint({ 
+    description: "Operation to perform",
+    enum: ["add", "subtract", "multiply", "divide"],
+    default: "add"
+  })
+  operation?: string;
+}
+
+export class ExampleService {
+  @Tool({ 
+    description: "Perform arithmetic operations with automatic schema validation",
+    inputClass: CalculateInput
+  })
+  async calculate(input: CalculateInput) {
+    let result: number;
+    
+    switch (input.operation || "add") {
+      case "add":
+        result = input.a + input.b;
+        break;
+      case "subtract":
+        result = input.a - input.b;
+        break;
+      case "multiply":
+        result = input.a * input.b;
+        break;
+      case "divide":
+        if (input.b === 0) throw new Error("Cannot divide by zero");
+        result = input.a / input.b;
+        break;
+      default:
+        throw new Error("Invalid operation");
+    }
+
+    return {
+      content: [{
+        type: "text" as const,
+        text: JSON.stringify({
+          operation: input.operation || "add",
+          operands: { a: input.a, b: input.b },
+          result
+        }, null, 2)
+      }]
+    };
+  }
+
+  @Tool({ description: "Echo a message back" })
+  async echo(input: { message: string }) {
+    return {
+      content: [{
+        type: "text" as const,
+        text: JSON.stringify({
+          echoed: input.message,
+          timestamp: new Date().toISOString()
+        }, null, 2)
+      }]
+    };
+  }
+
+  @Resource({ description: "Get server information" })
+  async serverInfo() {
+    return {
+      contents: [{
+        uri: "server://info",
+        mimeType: "application/json",
+        text: JSON.stringify({
+          name: "${projectName}",
+          version: "1.0.0",
+          uptime: process.uptime()
+        }, null, 2)
+      }]
+    };
+  }
+
+  @Prompt({ description: "Generate a greeting prompt" })
+  async greeting(args: { name?: string }) {
+    return {
+      messages: [{
+        role: "user" as const,
+        content: {
+          type: "text" as const,
+          text: \`Hello \${args.name || 'there'}! Welcome to ${projectName}.\`
+        }
+      }]
+    };
+  }
+}
+`;
+  await fs.writeFile(path.join(targetDir, "mcp", "example.ts"), exampleServiceTs);
+  const gitignore = `node_modules
+dist
+.env
+.env.local
+*.log
+`;
+  const env = `# Server Configuration
+PORT=3001
+NODE_ENV=development
+
+# Add your environment variables here
+`;
+  await fs.writeFile(path.join(targetDir, ".gitignore"), gitignore);
+  await fs.writeFile(path.join(targetDir, ".env"), env);
+  const readme = `# ${projectName}
+
+MCP Server with Streamable HTTP Transport built with LeanMCP SDK
+
+## Quick Start
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Start development server (hot reload)
+npm run dev
+
+# Build for production
+npm run build
+
+# Run production server
+npm start
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${projectName}/
+\u251C\u2500\u2500 main.ts              # Server entry point
+\u251C\u2500\u2500 mcp/
+\u2502   \u2514\u2500\u2500 example.ts       # Example service
+\u251C\u2500\u2500 .env                 # Environment variables
+\u2514\u2500\u2500 package.json
+\`\`\`
+
+## Adding New Services
+
+Create a new service file in \`mcp/\`:
+
+\`\`\`typescript
+import { Tool } from "@leanmcp/core";
+
+export class MyService {
+  @Tool({ description: "My awesome tool" })
+  async myTool(input: { message: string }) {
+    return {
+      content: [{
+        type: "text",
+        text: \`You said: \${input.message}\`
+      }]
+    };
+  }
+}
+\`\`\`
+
+Then register it in \`main.ts\`:
+
+\`\`\`typescript
+import { MyService } from "./mcp/my-service.js";
+server.registerService(new MyService());
+\`\`\`
+
+## Testing with MCP Inspector
+
+\`\`\`bash
+npx @modelcontextprotocol/inspector http://localhost:3001/mcp
+\`\`\`
+
+## License
+
+MIT
+`;
+  await fs.writeFile(path.join(targetDir, "README.md"), readme);
+  spinner.succeed(`Project ${projectName} created!`);
+  console.log(chalk.green("\\nSuccess! Your MCP server is ready.\\n"));
+  console.log(chalk.cyan("Next steps:"));
+  console.log(chalk.gray(`  cd ${projectName}`));
+  console.log(chalk.gray(`  npm install`));
+  console.log(chalk.gray(`  npm run dev`));
+  console.log(chalk.gray(`\\nServer will run on http://localhost:3001`));
+});
+program.command("add <serviceName>").description("Add a new MCP service to your project").action(async (serviceName) => {
+  const cwd = process.cwd();
+  const mcpDir = path.join(cwd, "mcp");
+  if (!fs.existsSync(path.join(cwd, "main.ts"))) {
+    console.error(chalk.red("ERROR: Not a LeanMCP project (main.ts missing)."));
+    process.exit(1);
+  }
+  await fs.mkdirp(mcpDir);
+  const serviceFile = path.join(mcpDir, `${serviceName}.ts`);
+  if (fs.existsSync(serviceFile)) {
+    console.error(chalk.red(`ERROR: Service ${serviceName} already exists.`));
+    process.exit(1);
+  }
+  const indexTs = `import { Tool, Resource, Prompt, Optional, SchemaConstraint } from "@leanmcp/core";
+
+// Input schema for greeting
+class GreetInput {
+  @SchemaConstraint({
+    description: "Name to greet",
+    minLength: 1
+  })
+  name!: string;
+}
+
+/**
+ * ${capitalize(serviceName)} Service
+ * 
+ * This service demonstrates the three types of MCP primitives:
+ * - Tools: Callable functions (like API endpoints)
+ * - Prompts: Reusable prompt templates
+ * - Resources: Data sources/endpoints
+ */
+export class ${capitalize(serviceName)}Service {
+  // TOOL - Callable function
+  // Tool name: "greet" (from function name)
+  @Tool({ 
+    description: "Greet a user by name",
+    inputClass: GreetInput
+  })
+  greet(args: GreetInput) {
+    return { message: \`Hello, \${args.name}! from ${serviceName}\` };
+  }
+
+  // PROMPT - Prompt template
+  // Prompt name: "welcomePrompt" (from function name)
+  @Prompt({ description: "Welcome message prompt template" })
+  welcomePrompt(args: { userName?: string }) {
+    return {
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: \`Welcome \${args.userName || 'user'}! How can I help you with ${serviceName}?\`
+          }
+        }
+      ]
+    };
+  }
+
+  // RESOURCE - Data endpoint
+  // Resource URI auto-generated from class and method name
+  @Resource({ description: "${capitalize(serviceName)} service status" })
+  getStatus() {
+    return { 
+      service: "${serviceName}", 
+      status: "active",
+      timestamp: new Date().toISOString()
+    };
+  }
+}
+`;
+  await fs.writeFile(serviceFile, indexTs);
+  const mainTsPath = path.join(cwd, "main.ts");
+  let mainTsContent = await fs.readFile(mainTsPath, "utf-8");
+  const serviceClassName = `${capitalize(serviceName)}Service`;
+  const importStatement = `import { ${serviceClassName} } from "./mcp/${serviceName}.js";`;
+  const registerStatement = `  server.registerService(new ${serviceClassName}());`;
+  const lastImportMatch = mainTsContent.match(/import .* from .*;\n/g);
+  if (lastImportMatch) {
+    const lastImport = lastImportMatch[lastImportMatch.length - 1];
+    const lastImportIndex = mainTsContent.lastIndexOf(lastImport);
+    const afterLastImport = lastImportIndex + lastImport.length;
+    mainTsContent = mainTsContent.slice(0, afterLastImport) + importStatement + "\n" + mainTsContent.slice(afterLastImport);
+  }
+  const registerPattern = /server\.registerService\(new \w+\(\)\);/g;
+  const matches = [
+    ...mainTsContent.matchAll(registerPattern)
+  ];
+  if (matches.length > 0) {
+    const lastMatch = matches[matches.length - 1];
+    const insertPosition = lastMatch.index + lastMatch[0].length;
+    mainTsContent = mainTsContent.slice(0, insertPosition) + "\n" + registerStatement + mainTsContent.slice(insertPosition);
+  }
+  await fs.writeFile(mainTsPath, mainTsContent);
+  console.log(chalk.green(`\\nCreated new service: ${chalk.bold(serviceName)}`));
+  console.log(chalk.gray(`   File: mcp/${serviceName}.ts`));
+  console.log(chalk.gray(`   Tool: greet`));
+  console.log(chalk.gray(`   Prompt: welcomePrompt`));
+  console.log(chalk.gray(`   Resource: getStatus`));
+  console.log(chalk.green(`\\nService automatically registered in main.ts!`));
+});
+program.parse();

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@leanmcp/cli",
+  "version": "0.1.0",
+  "description": "Command-line interface for scaffolding LeanMCP projects",
+  "bin": {
+    "leanmcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.1.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LeanMCP/leanmcp-sdk.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/LeanMCP/leanmcp-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/LeanMCP/leanmcp-sdk/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cli",
+    "scaffolding",
+    "generator",
+    "typescript"
+  ],
+  "author": "LeanMCP <admin@leanmcp.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}