leanmcp 0.3.1

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,184 @@
+# LeanMCP SDK
+
+A TypeScript SDK for building **Model Context Protocol (MCP)** servers with type-safe decorators and streamable HTTP support.
+
+## Installation
+
+```bash
+npm install leanmcp
+```
+
+This meta-package includes all LeanMCP packages:
+- `@leanmcp/core` - Core decorators, server, and runtime
+- `@leanmcp/auth` - Authentication and authorization
+- `@leanmcp/ui` - React UI components for MCP Apps
+- `@leanmcp/utils` - Utility functions
+- `@leanmcp/elicitation` - Interactive prompts and forms
+- `@leanmcp/env-injection` - Environment variable management
+
+## Quick Start
+
+### 1. Create a new project
+
+```bash
+npx @leanmcp/cli create my-mcp-server
+cd my-mcp-server
+npm install
+```
+
+### 2. Define your service
+
+```typescript
+import { Tool, SchemaConstraint } from 'leanmcp';
+
+class GreetInput {
+  @SchemaConstraint({
+    description: 'Name to greet',
+    minLength: 1
+  })
+  name!: string;
+}
+
+export class GreetingService {
+  @Tool({ 
+    description: 'Greet someone',
+    inputClass: GreetInput
+  })
+  async greet(args: GreetInput) {
+    return { message: `Hello, ${args.name}!` };
+  }
+}
+```
+
+### 3. Run your server
+
+```bash
+npm start
+```
+
+Your MCP server starts on `http://localhost:8080` with:
+- HTTP endpoint: `http://localhost:8080/mcp`
+- Health check: `http://localhost:8080/health`
+
+## Features
+
+- **Type-safe decorators** - Full TypeScript support with compile-time validation
+- **Declarative schema definition** - Define JSON Schema using `@SchemaConstraint` decorators
+- **Clean API** - Function names become tool/prompt/resource names automatically
+- **MCP compliant** - Built on official @modelcontextprotocol/sdk
+- **Streamable HTTP** - Production-ready HTTP server with session management
+- **Authentication** - Built-in `@Authenticated` decorator with multi-provider support
+- **Interactive CLI** - Guided project setup with dependency installation
+- **React UI Components** - Build interactive MCP apps with pre-built components
+- **Built-in validation** - Automatic input validation using defined schemas
+
+## Usage Examples
+
+### Core Server
+
+```typescript
+import { createHTTPServer, Tool } from 'leanmcp';
+
+// Services are automatically discovered from ./mcp directory
+await createHTTPServer({
+  name: "my-mcp-server",
+  version: "1.0.0",
+  port: 8080,
+  cors: true,
+  logging: true
+});
+```
+
+### Authentication
+
+```typescript
+import { Tool, AuthProvider, Authenticated } from 'leanmcp';
+
+const authProvider = new AuthProvider('cognito', {
+  region: process.env.AWS_REGION,
+  userPoolId: process.env.COGNITO_USER_POOL_ID,
+  clientId: process.env.COGNITO_CLIENT_ID
+});
+await authProvider.init();
+
+@Authenticated(authProvider)
+export class SecureService {
+  @Tool({ description: 'Protected endpoint' })
+  async protectedMethod(args: any) {
+    return { success: true };
+  }
+}
+```
+
+### React UI Components
+
+```typescript
+import { AppProvider, AppShell, HTTPTransport } from 'leanmcp/ui';
+import 'leanmcp/ui/styles.css';
+
+function App() {
+  const transport = new HTTPTransport('http://localhost:8080/mcp');
+  
+  return (
+    <AppProvider transport={transport}>
+      <AppShell />
+    </AppProvider>
+  );
+}
+```
+
+## Package Exports
+
+### Main Export
+
+```typescript
+import { createHTTPServer, Tool, Prompt, Resource } from 'leanmcp';
+```
+
+### UI Components
+
+```typescript
+import { AppProvider, AppShell } from 'leanmcp/ui';
+import 'leanmcp/ui/styles.css';
+```
+
+### Individual Packages
+
+You can also install individual packages if you only need specific functionality:
+
+```bash
+npm install @leanmcp/core        # Core decorators and server
+npm install @leanmcp/auth        # Authentication
+npm install @leanmcp/ui          # React UI components
+npm install @leanmcp/cli         # CLI tools
+```
+
+## Documentation
+
+For complete documentation, examples, and API reference, visit:
+- [GitHub Repository](https://github.com/LeanMCP/leanmcp-sdk)
+- [Full Documentation](https://github.com/LeanMCP/leanmcp-sdk#readme)
+
+## CLI Commands
+
+### Create a new project
+
+```bash
+npx @leanmcp/cli create my-mcp-server
+```
+
+### Add a service to existing project
+
+```bash
+npx @leanmcp/cli add weather
+```
+
+## License
+
+MIT
+
+## Links
+
+- [MCP Specification](https://modelcontextprotocol.io/)
+- [GitHub Repository](https://github.com/LeanMCP/leanmcp-sdk)
+- [Issues](https://github.com/LeanMCP/leanmcp-sdk/issues)

package/dist/index.d.mts

@@ -0,0 +1,9 @@
+export * from '@leanmcp/core';
+export { MCPServer, MCPServerConstructorOptions, Optional, Prompt, Resource, SchemaConstraint, Tool, createHTTPServer } from '@leanmcp/core';
+export * from '@leanmcp/auth';
+export { AuthProvider, AuthProviderBase, Authenticated, AuthenticatedOptions } from '@leanmcp/auth';
+export * from '@leanmcp/ui';
+export { ActionButton, AppProvider, AppProviderProps, AppShell, AppShellProps, Button, Card, CardContent, CardFooter, CardHeader, Chart, CodeBlock, DataGrid, HTTPTransport, HTTPTransportConfig, Input, MCPPrompt, MCPResource, MCPTool, ToolForm, useMcpApp, useTool, useToolSubscription } from '@leanmcp/ui';
+export * from '@leanmcp/utils';
+export * from '@leanmcp/elicitation';
+export * from '@leanmcp/env-injection';

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from '@leanmcp/core';
+export { MCPServer, MCPServerConstructorOptions, Optional, Prompt, Resource, SchemaConstraint, Tool, createHTTPServer } from '@leanmcp/core';
+export * from '@leanmcp/auth';
+export { AuthProvider, AuthProviderBase, Authenticated, AuthenticatedOptions } from '@leanmcp/auth';
+export * from '@leanmcp/ui';
+export { ActionButton, AppProvider, AppProviderProps, AppShell, AppShellProps, Button, Card, CardContent, CardFooter, CardHeader, Chart, CodeBlock, DataGrid, HTTPTransport, HTTPTransportConfig, Input, MCPPrompt, MCPResource, MCPTool, ToolForm, useMcpApp, useTool, useToolSubscription } from '@leanmcp/ui';
+export * from '@leanmcp/utils';
+export * from '@leanmcp/elicitation';
+export * from '@leanmcp/env-injection';

package/dist/index.js

@@ -0,0 +1,97 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: 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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ActionButton: () => import_ui.ActionButton,
+  AppProvider: () => import_ui.AppProvider,
+  AppShell: () => import_ui.AppShell,
+  AuthProvider: () => import_auth.AuthProvider,
+  AuthProviderBase: () => import_auth.AuthProviderBase,
+  Authenticated: () => import_auth.Authenticated,
+  Button: () => import_ui.Button,
+  Card: () => import_ui.Card,
+  CardContent: () => import_ui.CardContent,
+  CardFooter: () => import_ui.CardFooter,
+  CardHeader: () => import_ui.CardHeader,
+  Chart: () => import_ui.Chart,
+  CodeBlock: () => import_ui.CodeBlock,
+  DataGrid: () => import_ui.DataGrid,
+  HTTPTransport: () => import_ui.HTTPTransport,
+  Input: () => import_ui.Input,
+  MCPServer: () => import_core.MCPServer,
+  Optional: () => import_core.Optional,
+  Prompt: () => import_core.Prompt,
+  Resource: () => import_core.Resource,
+  SchemaConstraint: () => import_core.SchemaConstraint,
+  Tool: () => import_core.Tool,
+  ToolForm: () => import_ui.ToolForm,
+  createHTTPServer: () => import_core.createHTTPServer,
+  useMcpApp: () => import_ui.useMcpApp,
+  useTool: () => import_ui.useTool,
+  useToolSubscription: () => import_ui.useToolSubscription
+});
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("@leanmcp/core"), module.exports);
+var import_core = require("@leanmcp/core");
+__reExport(index_exports, require("@leanmcp/auth"), module.exports);
+var import_auth = require("@leanmcp/auth");
+__reExport(index_exports, require("@leanmcp/ui"), module.exports);
+var import_ui = require("@leanmcp/ui");
+__reExport(index_exports, require("@leanmcp/utils"), module.exports);
+__reExport(index_exports, require("@leanmcp/elicitation"), module.exports);
+__reExport(index_exports, require("@leanmcp/env-injection"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ActionButton,
+  AppProvider,
+  AppShell,
+  AuthProvider,
+  AuthProviderBase,
+  Authenticated,
+  Button,
+  Card,
+  CardContent,
+  CardFooter,
+  CardHeader,
+  Chart,
+  CodeBlock,
+  DataGrid,
+  HTTPTransport,
+  Input,
+  MCPServer,
+  Optional,
+  Prompt,
+  Resource,
+  SchemaConstraint,
+  Tool,
+  ToolForm,
+  createHTTPServer,
+  useMcpApp,
+  useTool,
+  useToolSubscription,
+  ...require("@leanmcp/core"),
+  ...require("@leanmcp/auth"),
+  ...require("@leanmcp/ui"),
+  ...require("@leanmcp/utils"),
+  ...require("@leanmcp/elicitation"),
+  ...require("@leanmcp/env-injection")
+});

package/dist/index.mjs

@@ -0,0 +1,65 @@
+// src/index.ts
+export * from "@leanmcp/core";
+import {
+  createHTTPServer,
+  MCPServer,
+  Tool,
+  Prompt,
+  Resource,
+  Optional,
+  SchemaConstraint
+} from "@leanmcp/core";
+export * from "@leanmcp/auth";
+import { AuthProvider, AuthProviderBase, Authenticated } from "@leanmcp/auth";
+export * from "@leanmcp/ui";
+import {
+  AppProvider,
+  useMcpApp,
+  AppShell,
+  HTTPTransport,
+  useTool,
+  useToolSubscription,
+  ActionButton,
+  ToolForm,
+  Button,
+  Card,
+  CardHeader,
+  CardContent,
+  CardFooter,
+  Input,
+  DataGrid,
+  Chart,
+  CodeBlock
+} from "@leanmcp/ui";
+export * from "@leanmcp/utils";
+export * from "@leanmcp/elicitation";
+export * from "@leanmcp/env-injection";
+export {
+  ActionButton,
+  AppProvider,
+  AppShell,
+  AuthProvider,
+  AuthProviderBase,
+  Authenticated,
+  Button,
+  Card,
+  CardContent,
+  CardFooter,
+  CardHeader,
+  Chart,
+  CodeBlock,
+  DataGrid,
+  HTTPTransport,
+  Input,
+  MCPServer,
+  Optional,
+  Prompt,
+  Resource,
+  SchemaConstraint,
+  Tool,
+  ToolForm,
+  createHTTPServer,
+  useMcpApp,
+  useTool,
+  useToolSubscription
+};

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "leanmcp",
+  "version": "0.3.1",
+  "description": "LeanMCP SDK - TypeScript SDK for building Model Context Protocol (MCP) servers with type-safe decorators",
+  "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"
+    },
+    "./ui": {
+      "types": "./node_modules/@leanmcp/ui/dist/index.d.ts",
+      "require": "./node_modules/@leanmcp/ui/dist/index.js",
+      "import": "./node_modules/@leanmcp/ui/dist/index.mjs"
+    },
+    "./ui/styles.css": "./node_modules/@leanmcp/ui/dist/index.css"
+  },
+  "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": "jest --passWithNoTests",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@leanmcp/core": "^0.3.1",
+    "@leanmcp/auth": "^0.3.1",
+    "@leanmcp/ui": "^0.1.0",
+    "@leanmcp/utils": "^0.1.0",
+    "@leanmcp/elicitation": "^0.1.0",
+    "@leanmcp/env-injection": "^0.1.0"
+  },
+  "devDependencies": {
+    "@leanmcp/cli": "^0.2.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LeanMCP/leanmcp-sdk.git",
+    "directory": "packages/leanmcp"
+  },
+  "homepage": "https://github.com/LeanMCP/leanmcp-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/LeanMCP/leanmcp-sdk/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "typescript",
+    "decorators",
+    "server",
+    "runtime",
+    "sdk",
+    "authentication",
+    "ui",
+    "react"
+  ],
+  "author": "LeanMCP <admin@leanmcp.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}