@leanmcp/cli 0.5.0 → 0.5.1

package/dist/index.js

@@ -1742,9 +1742,14 @@ async function deployCommand(folderPath, options = {}) {
   }
   const hasMainTs = await fs8.pathExists(path8.join(absolutePath, "main.ts"));
   const hasPackageJson = await fs8.pathExists(path8.join(absolutePath, "package.json"));
-  if (!hasMainTs && !hasPackageJson) {
+  const hasMainPy = await fs8.pathExists(path8.join(absolutePath, "main.py"));
+  const hasRequirementsTxt = await fs8.pathExists(path8.join(absolutePath, "requirements.txt"));
+  const hasPyprojectToml = await fs8.pathExists(path8.join(absolutePath, "pyproject.toml"));
+  const isNodeProject = hasMainTs || hasPackageJson;
+  const isPythonProject = hasMainPy || hasRequirementsTxt || hasPyprojectToml;
+  if (!isNodeProject && !isPythonProject) {
     logger.error("Not a valid project folder.");
-    logger.gray("Expected main.ts or package.json in the folder.\n");
+    logger.gray("Expected one of: main.ts, package.json, main.py, requirements.txt, or pyproject.toml\n");
     process.exit(1);
   }
   const existingConfig = await readLeanMCPConfig(absolutePath);
@@ -3160,6 +3165,219 @@ export class ${capitalizedName}Service {
 }
 `, "getServiceIndexTemplate");
 
+// src/templates/python/main_py_v1.ts
+var getPythonMainTemplate = /* @__PURE__ */ __name((projectName) => `#!/usr/bin/env python3
+"""
+${projectName} - MCP Server with Streamable HTTP Transport
+"""
+import os
+import uvicorn
+from dotenv import load_dotenv
+from mcp.server.fastmcp import FastMCP
+
+# Load environment variables
+load_dotenv()
+
+# Create the MCP server
+mcp = FastMCP("${projectName}")
+
+
+# === Define your tools, resources, and prompts below ===
+
+@mcp.tool()
+def calculate(a: float, b: float, operation: str = "add") -> dict:
+    """
+    Perform arithmetic operations.
+    
+    Args:
+        a: First number
+        b: Second number  
+        operation: Operation to perform (add, subtract, multiply, divide)
+    """
+    if operation == "add":
+        result = a + b
+    elif operation == "subtract":
+        result = a - b
+    elif operation == "multiply":
+        result = a * b
+    elif operation == "divide":
+        if b == 0:
+            raise ValueError("Cannot divide by zero")
+        result = a / b
+    else:
+        raise ValueError(f"Invalid operation: {operation}")
+    
+    return {"operation": operation, "a": a, "b": b, "result": result}
+
+
+@mcp.tool()
+def echo(message: str) -> dict:
+    """Echo a message back with a timestamp."""
+    from datetime import datetime
+    return {"echoed": message, "timestamp": datetime.now().isoformat()}
+
+
+@mcp.resource("server://info")
+def server_info() -> str:
+    """Get server information."""
+    import json
+    import time
+    return json.dumps({
+        "name": "${projectName}",
+        "version": "1.0.0",
+        "uptime": time.process_time()
+    }, indent=2)
+
+
+@mcp.prompt()
+def greeting(name: str = "there") -> str:
+    """Generate a greeting prompt."""
+    return f"Hello {name}! Welcome to ${projectName}."
+
+
+if __name__ == "__main__":
+    port = int(os.getenv("PORT", "3001"))
+    print(f"\\n${projectName} MCP Server starting on port {port}...")
+    
+    # Run with streamable HTTP transport
+    uvicorn.run(
+        mcp.streamable_http_app(),
+        host="127.0.0.1",
+        port=port,
+        log_level="info"
+    )
+`, "getPythonMainTemplate");
+
+// src/templates/python/requirements_v1.ts
+var getPythonRequirementsTemplate = /* @__PURE__ */ __name(() => `# MCP Server Dependencies
+mcp>=1.0.0
+fastmcp>=0.1.0
+uvicorn>=0.30.0
+python-dotenv>=1.0.0
+pydantic>=2.0.0
+
+# Optional: Add your dependencies below
+# requests>=2.31.0
+# httpx>=0.27.0
+`, "getPythonRequirementsTemplate");
+
+// src/templates/python/gitignore_py_v1.ts
+var pythonGitignoreTemplate = `# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+venv/
+.venv/
+ENV/
+env/
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Logs
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+`;
+
+// src/templates/python/readme_py_v1.ts
+var getPythonReadmeTemplate = /* @__PURE__ */ __name((projectName) => `# ${projectName}
+
+A Python MCP (Model Context Protocol) server with Streamable HTTP transport.
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.10+
+- pip or uv package manager
+
+### Installation
+
+\`\`\`bash
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\\Scripts\\activate
+
+# Install dependencies
+pip install -r requirements.txt
+\`\`\`
+
+### Development
+
+\`\`\`bash
+# Start development server
+python main.py
+\`\`\`
+
+Server runs at http://localhost:3001
+
+### Test with MCP Inspector
+
+\`\`\`bash
+npx @modelcontextprotocol/inspector http://localhost:3001/mcp
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${projectName}/
+  main.py              # Server entry point with tools/resources/prompts
+  requirements.txt     # Python dependencies
+  .env                 # Environment variables
+\`\`\`
+
+## Adding New Tools
+
+Add tools directly in \`main.py\` using the \`@mcp.tool()\` decorator:
+
+\`\`\`python
+@mcp.tool()
+def my_tool(param: str) -> dict:
+    """Tool description shown to AI.
+    
+    Args:
+        param: Parameter description
+    """
+    return {"result": param}
+\`\`\`
+
+## Deploy to LeanMCP Cloud
+
+\`\`\`bash
+leanmcp deploy .
+\`\`\`
+
+## Resources
+
+- [MCP Documentation](https://modelcontextprotocol.io)
+- [FastMCP Documentation](https://github.com/jlowin/fastmcp)
+- [LeanMCP Documentation](https://docs.leanmcp.com)
+`, "getPythonReadmeTemplate");
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
@@ -3182,7 +3400,8 @@ __name(enableDebugIfNeeded, "enableDebugIfNeeded");
 enableDebugIfNeeded();
 program.name("leanmcp").description("LeanMCP CLI \u2014 create production-ready MCP servers with Streamable HTTP").version(pkg.version, "-v, --version", "Output the current version").helpOption("-h, --help", "Display help for command").option("-d, --debug", "Enable debug logging for all commands").addHelpText("after", `
 Examples:
-  $ leanmcp create my-app                # Create new project (interactive)
+  $ leanmcp create my-app                # Create new TypeScript project (interactive)
+  $ leanmcp create my-app --python       # Create new Python project
   $ leanmcp create my-app -i             # Create and install deps (non-interactive)
   $ leanmcp create my-app --no-install   # Create without installing deps
   $ leanmcp dev                          # Start development server
@@ -3200,7 +3419,7 @@ Global Options:
   -h, --help       Display help for command
   -d, --debug      Enable debug logging for all commands
 `);
-program.command("create <projectName>").description("Create a new LeanMCP project with Streamable HTTP transport").option("--allow-all", "Skip interactive confirmations and assume Yes").option("--no-dashboard", "Disable dashboard UI at / and /mcp GET endpoints").option("-i, --install", "Install dependencies automatically (non-interactive, no dev server)").option("--no-install", "Skip dependency installation (non-interactive)").action(async (projectName, options) => {
+program.command("create <projectName>").description("Create a new LeanMCP project with Streamable HTTP transport").option("--allow-all", "Skip interactive confirmations and assume Yes").option("--no-dashboard", "Disable dashboard UI at / and /mcp GET endpoints").option("-i, --install", "Install dependencies automatically (non-interactive, no dev server)").option("--no-install", "Skip dependency installation (non-interactive)").option("--python", "Create a Python MCP project instead of TypeScript").action(async (projectName, options) => {
   trackCommand("create", {
     projectName,
     ...options
@@ -3212,85 +3431,102 @@ program.command("create <projectName>").description("Create a new LeanMCP projec
     process.exit(1);
   }
   await fs10.mkdirp(targetDir);
-  await fs10.mkdirp(path10.join(targetDir, "mcp", "example"));
-  const pkg2 = {
-    name: projectName,
-    version: "1.0.0",
-    description: "MCP Server with Streamable HTTP Transport and LeanMCP SDK",
-    main: "dist/main.js",
-    type: "module",
-    scripts: {
-      dev: "leanmcp dev",
-      build: "leanmcp build",
-      start: "leanmcp start",
-      inspect: "npx @modelcontextprotocol/inspector node dist/main.js",
-      "start:node": "node dist/main.js",
-      clean: "rm -rf dist"
-    },
-    keywords: [
-      "mcp",
-      "model-context-protocol",
-      "streamable-http",
-      "leanmcp"
-    ],
-    author: "",
-    license: "MIT",
-    dependencies: {
-      "@leanmcp/core": "^0.3.14",
-      "@leanmcp/ui": "^0.2.1",
-      "@leanmcp/auth": "^0.4.0",
-      "dotenv": "^16.5.0"
-    },
-    devDependencies: {
-      "@leanmcp/cli": "^0.4.0",
-      "@types/node": "^20.0.0",
-      "tsx": "^4.20.3",
-      "typescript": "^5.6.3"
-    }
-  };
-  await fs10.writeJSON(path10.join(targetDir, "package.json"), pkg2, {
-    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 fs10.writeJSON(path10.join(targetDir, "tsconfig.json"), tsconfig, {
-    spaces: 2
-  });
-  const dashboardLine = options.dashboard === false ? `
+  const isPython = options.python === true;
+  if (isPython) {
+    const requirements = getPythonRequirementsTemplate();
+    await fs10.writeFile(path10.join(targetDir, "requirements.txt"), requirements);
+    const mainPy = getPythonMainTemplate(projectName);
+    await fs10.writeFile(path10.join(targetDir, "main.py"), mainPy);
+    await fs10.writeFile(path10.join(targetDir, ".gitignore"), pythonGitignoreTemplate);
+    const env = `# Server Configuration
+PORT=3001
+
+# Add your environment variables here
+`;
+    await fs10.writeFile(path10.join(targetDir, ".env"), env);
+    const readme = getPythonReadmeTemplate(projectName);
+    await fs10.writeFile(path10.join(targetDir, "README.md"), readme);
+  } else {
+    await fs10.mkdirp(path10.join(targetDir, "mcp", "example"));
+    const pkg2 = {
+      name: projectName,
+      version: "1.0.0",
+      description: "MCP Server with Streamable HTTP Transport and LeanMCP SDK",
+      main: "dist/main.js",
+      type: "module",
+      scripts: {
+        dev: "leanmcp dev",
+        build: "leanmcp build",
+        start: "leanmcp start",
+        inspect: "npx @modelcontextprotocol/inspector node dist/main.js",
+        "start:node": "node dist/main.js",
+        clean: "rm -rf dist"
+      },
+      keywords: [
+        "mcp",
+        "model-context-protocol",
+        "streamable-http",
+        "leanmcp"
+      ],
+      author: "",
+      license: "MIT",
+      dependencies: {
+        "@leanmcp/core": "^0.3.14",
+        "@leanmcp/ui": "^0.2.1",
+        "@leanmcp/auth": "^0.4.0",
+        "dotenv": "^16.5.0"
+      },
+      devDependencies: {
+        "@leanmcp/cli": "^0.4.0",
+        "@types/node": "^20.0.0",
+        "tsx": "^4.20.3",
+        "typescript": "^5.6.3"
+      }
+    };
+    await fs10.writeJSON(path10.join(targetDir, "package.json"), pkg2, {
+      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 fs10.writeJSON(path10.join(targetDir, "tsconfig.json"), tsconfig, {
+      spaces: 2
+    });
+    const dashboardLine = options.dashboard === false ? `
   dashboard: false,  // Dashboard disabled via --no-dashboard` : "";
-  const mainTs = getMainTsTemplate(projectName, dashboardLine);
-  await fs10.writeFile(path10.join(targetDir, "main.ts"), mainTs);
-  const exampleServiceTs = getExampleServiceTemplate(projectName);
-  await fs10.writeFile(path10.join(targetDir, "mcp", "example", "index.ts"), exampleServiceTs);
-  const gitignore = gitignoreTemplate;
-  const env = `# Server Configuration
+    const mainTs = getMainTsTemplate(projectName, dashboardLine);
+    await fs10.writeFile(path10.join(targetDir, "main.ts"), mainTs);
+    const exampleServiceTs = getExampleServiceTemplate(projectName);
+    await fs10.writeFile(path10.join(targetDir, "mcp", "example", "index.ts"), exampleServiceTs);
+    const gitignore = gitignoreTemplate;
+    const env = `# Server Configuration
 PORT=3001
 NODE_ENV=development
 
 # Add your environment variables here
 `;
-  await fs10.writeFile(path10.join(targetDir, ".gitignore"), gitignore);
-  await fs10.writeFile(path10.join(targetDir, ".env"), env);
-  const readme = getReadmeTemplate(projectName);
-  await fs10.writeFile(path10.join(targetDir, "README.md"), readme);
+    await fs10.writeFile(path10.join(targetDir, ".gitignore"), gitignore);
+    await fs10.writeFile(path10.join(targetDir, ".env"), env);
+    const readme = getReadmeTemplate(projectName);
+    await fs10.writeFile(path10.join(targetDir, "README.md"), readme);
+  }
   spinner.succeed(`Project ${projectName} created!`);
   logger.log("\nSuccess! Your MCP server is ready.\n", chalk.green);
   logger.log("To deploy to LeanMCP cloud:", chalk.cyan);
@@ -3303,8 +3539,28 @@ NODE_ENV=development
   if (options.install === false) {
     logger.log("To get started:", chalk.cyan);
     logger.log(`  cd ${projectName}`, chalk.gray);
-    logger.log(`  npm install`, chalk.gray);
-    logger.log(`  npm run dev`, chalk.gray);
+    if (isPython) {
+      logger.log(`  python -m venv venv`, chalk.gray);
+      logger.log(`  source venv/bin/activate  # On Windows: venv\\Scripts\\activate`, chalk.gray);
+      logger.log(`  pip install -r requirements.txt`, chalk.gray);
+      logger.log(`  python main.py`, chalk.gray);
+    } else {
+      logger.log(`  npm install`, chalk.gray);
+      logger.log(`  npm run dev`, chalk.gray);
+    }
+    logger.log("");
+    logger.log("To deploy to LeanMCP cloud:", chalk.cyan);
+    logger.log(`  cd ${projectName}`, chalk.gray);
+    logger.log(`  leanmcp deploy .`, chalk.gray);
+    return;
+  }
+  if (isPython) {
+    logger.log("\nTo get started:", chalk.cyan);
+    logger.log(`  cd ${projectName}`, chalk.gray);
+    logger.log(`  python -m venv venv`, chalk.gray);
+    logger.log(`  source venv/bin/activate  # On Windows: venv\\Scripts\\activate`, chalk.gray);
+    logger.log(`  pip install -r requirements.txt`, chalk.gray);
+    logger.log(`  python main.py`, chalk.gray);
     logger.log("");
     logger.log("To deploy to LeanMCP cloud:", chalk.cyan);
     logger.log(`  cd ${projectName}`, chalk.gray);

package/package.json

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