@leanmcp/core 0.2.0 → 0.3.0

package/README.md

@@ -77,28 +77,18 @@ export class SentimentService {
 
 #### Option A: Zero-Config Auto-Discovery (Recommended)
 
-Automatically discover and register all services from the `./mcp` directory:
+The simplest way to create an HTTP server with auto-discovery:
 
 ```typescript
-import { createHTTPServer, MCPServer } from "@leanmcp/core";
-
-// Create MCP server with auto-discovery
-const serverFactory = async () => {
-  const server = new MCPServer({
-    name: "my-mcp-server",
-    version: "1.0.0",
-    logging: true  // Enable HTTP server logs
-  });
+import { createHTTPServer } from "@leanmcp/core";
 
-  // Services are automatically discovered and registered from ./mcp directory
-  return server.getServer();
-};
-
-// Start HTTP server
-await createHTTPServer(serverFactory, {
+// Create and start HTTP server with auto-discovery
+await createHTTPServer({
+  name: "my-mcp-server",
+  version: "1.0.0",
   port: 3000,
   cors: true,
-  logging: true  // Log HTTP requests
+  logging: true
 });
 
 console.log('\nMCP Server running');
@@ -106,6 +96,12 @@ console.log('HTTP endpoint: http://localhost:3000/mcp');
 console.log('Health check: http://localhost:3000/health');
 ```
 
+**What happens automatically:**
+- Services are discovered from `./mcp` directory
+- HTTP server is created and started
+- Session management is configured
+- CORS is enabled (if specified)
+
 **Directory Structure:**
 ```
 your-project/
@@ -119,15 +115,15 @@ your-project/
         └── index.ts    # export class DatabaseService
 ```
 
-#### Option B: Manual Registration
+#### Option B: Factory Pattern (Advanced)
 
-Manually import and register each service:
+For advanced use cases requiring manual service registration or custom configuration:
 
 ```typescript
 import { createHTTPServer, MCPServer } from "@leanmcp/core";
 import { SentimentService } from "./services/sentiment";
 
-// Create MCP server
+// Create MCP server with factory function
 const serverFactory = async () => {
   const server = new MCPServer({
     name: "my-mcp-server",
@@ -142,11 +138,11 @@ const serverFactory = async () => {
   return server.getServer();
 };
 
-// Start HTTP server
+// Start HTTP server with factory
 await createHTTPServer(serverFactory, {
   port: 3000,
   cors: true,
-  logging: true  // Log HTTP requests
+  logging: true
 });
 ```
 
@@ -295,32 +291,27 @@ server.getServer(): Server;
 
 Services are automatically discovered and registered from the `./mcp` directory when the server is created:
 
-**Basic Usage:**
+**Basic Usage (Simplified API):**
 ```typescript
-const serverFactory = async () => {
-  const server = new MCPServer({
-    name: "my-server",
-    version: "1.0.0",
-    logging: true  // Enable logging
-  });
+import { createHTTPServer } from "@leanmcp/core";
 
-  // Services are automatically discovered and registered
-  return server.getServer();
-};
+await createHTTPServer({
+  name: "my-server",
+  version: "1.0.0",
+  port: 3000,
+  logging: true  // Enable logging
+});
 ```
 
 **With Debug Logging:**
 ```typescript
-const serverFactory = async () => {
-  const server = new MCPServer({
-    name: "my-server",
-    version: "1.0.0",
-    logging: true,
-    debug: true  // Show detailed service registration logs
-  });
-
-  return server.getServer();
-};
+await createHTTPServer({
+  name: "my-server",
+  version: "1.0.0",
+  port: 3000,
+  logging: true,
+  debug: true  // Show detailed service registration logs
+});
 ```
 
 **With Shared Dependencies:**
@@ -369,16 +360,16 @@ export class SlackService {
 Your main file stays clean:
 
 ```typescript
-const serverFactory = async () => {
-  const server = new MCPServer({
-    name: "my-server",
-    version: "1.0.0",
-    logging: true
-  });
+import { createHTTPServer } from "@leanmcp/core";
 
-  // Services are automatically discovered and registered
-  return server.getServer();
-};
+await createHTTPServer({
+  name: "my-server",
+  version: "1.0.0",
+  port: 3000,
+  logging: true
+});
+
+// Services are automatically discovered and registered
 ```
 
 **How It Works:**
@@ -406,17 +397,54 @@ your-project/
 
 Create and start an HTTP server with streamable transport.
 
+**Simplified API (Recommended):**
+```typescript
+await createHTTPServer({
+  name: string;              // Server name (required)
+  version: string;           // Server version (required)
+  port?: number;             // Port number (default: 3001)
+  cors?: boolean | object;   // Enable CORS (default: false)
+  logging?: boolean;         // Enable logging (default: false)
+  debug?: boolean;           // Enable debug logs (default: false)
+  autoDiscover?: boolean;    // Auto-discover services (default: true)
+  mcpDir?: string;           // Custom mcp directory path (optional)
+  sessionTimeout?: number;   // Session timeout in ms (optional)
+});
+```
+
+**Factory Pattern (Advanced):**
 ```typescript
 await createHTTPServer(
   serverFactory: () => Server | Promise<Server>,
   options: {
-    port?: number;      // Port number (default: 3000)
-    cors?: boolean;     // Enable CORS (default: false)
-    logging?: boolean;  // Enable HTTP request logging (default: false)
+    port?: number;             // Port number (default: 3001)
+    cors?: boolean | object;   // Enable CORS (default: false)
+    logging?: boolean;         // Enable HTTP request logging (default: false)
+    sessionTimeout?: number;   // Session timeout in ms (optional)
   }
 );
 ```
 
+**CORS Configuration:**
+```typescript
+// Simple CORS (allow all origins - not recommended for production)
+await createHTTPServer({
+  name: "my-server",
+  version: "1.0.0",
+  cors: true
+});
+
+// Advanced CORS configuration
+await createHTTPServer({
+  name: "my-server",
+  version: "1.0.0",
+  cors: {
+    origin: 'https://example.com',  // Specific origin
+    credentials: true                // Allow credentials
+  }
+});
+```
+
 ### Schema Generation
 
 Generate JSON Schema from TypeScript classes:

package/dist/index.d.mts

@@ -223,11 +223,15 @@ interface HTTPServerOptions {
 interface MCPServerFactory {
     (): Server | Promise<Server>;
 }
+type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
 /**
  * Create an HTTP server for MCP with Streamable HTTP transport
  * Returns the HTTP server instance to keep the process alive
+ *
+ * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
+ * @param options - HTTP server options (only used when serverInput is a factory function)
  */
-declare function createHTTPServer(serverFactory: MCPServerFactory, options?: HTTPServerOptions): Promise<any>;
+declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
 
 /**
  * Input validation utilities for LeanMCP
@@ -324,6 +328,12 @@ interface MCPServerConstructorOptions {
     autoDiscover?: boolean;
     mcpDir?: string;
     serviceFactories?: Record<string, () => any>;
+    port?: number;
+    cors?: boolean | {
+        origin?: string | string[];
+        credentials?: boolean;
+    };
+    sessionTimeout?: number;
 }
 interface RegisteredTool {
     name: string;
@@ -487,4 +497,4 @@ declare class MCPServerRuntime {
  */
 declare function startMCPServer(options: MCPServerOptions): Promise<MCPServerRuntime>;
 
-export { Auth, type AuthOptions, Deprecated, type HTTPServerOptions, LogLevel, Logger, type LoggerOptions, MCPServer, type MCPServerConstructorOptions, type MCPServerFactory, type MCPServerOptions, MCPServerRuntime, Optional, Prompt, type PromptOptions, Render, Resource, type ResourceOptions, SchemaConstraint, Tool, type ToolOptions, UI, UserEnvs, classToJsonSchema, classToJsonSchemaWithConstraints, createHTTPServer, defaultLogger, getDecoratedMethods, getMethodMetadata, startMCPServer, validateNonEmpty, validatePath, validatePort, validateServiceName, validateUrl };
+export { Auth, type AuthOptions, Deprecated, type HTTPServerInput, type HTTPServerOptions, LogLevel, Logger, type LoggerOptions, MCPServer, type MCPServerConstructorOptions, type MCPServerFactory, type MCPServerOptions, MCPServerRuntime, Optional, Prompt, type PromptOptions, Render, Resource, type ResourceOptions, SchemaConstraint, Tool, type ToolOptions, UI, UserEnvs, classToJsonSchema, classToJsonSchemaWithConstraints, createHTTPServer, defaultLogger, getDecoratedMethods, getMethodMetadata, startMCPServer, validateNonEmpty, validatePath, validatePort, validateServiceName, validateUrl };

package/dist/index.d.ts

@@ -223,11 +223,15 @@ interface HTTPServerOptions {
 interface MCPServerFactory {
     (): Server | Promise<Server>;
 }
+type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
 /**
  * Create an HTTP server for MCP with Streamable HTTP transport
  * Returns the HTTP server instance to keep the process alive
+ *
+ * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
+ * @param options - HTTP server options (only used when serverInput is a factory function)
  */
-declare function createHTTPServer(serverFactory: MCPServerFactory, options?: HTTPServerOptions): Promise<any>;
+declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
 
 /**
  * Input validation utilities for LeanMCP
@@ -324,6 +328,12 @@ interface MCPServerConstructorOptions {
     autoDiscover?: boolean;
     mcpDir?: string;
     serviceFactories?: Record<string, () => any>;
+    port?: number;
+    cors?: boolean | {
+        origin?: string | string[];
+        credentials?: boolean;
+    };
+    sessionTimeout?: number;
 }
 interface RegisteredTool {
     name: string;
@@ -487,4 +497,4 @@ declare class MCPServerRuntime {
  */
 declare function startMCPServer(options: MCPServerOptions): Promise<MCPServerRuntime>;
 
-export { Auth, type AuthOptions, Deprecated, type HTTPServerOptions, LogLevel, Logger, type LoggerOptions, MCPServer, type MCPServerConstructorOptions, type MCPServerFactory, type MCPServerOptions, MCPServerRuntime, Optional, Prompt, type PromptOptions, Render, Resource, type ResourceOptions, SchemaConstraint, Tool, type ToolOptions, UI, UserEnvs, classToJsonSchema, classToJsonSchemaWithConstraints, createHTTPServer, defaultLogger, getDecoratedMethods, getMethodMetadata, startMCPServer, validateNonEmpty, validatePath, validatePort, validateServiceName, validateUrl };
+export { Auth, type AuthOptions, Deprecated, type HTTPServerInput, type HTTPServerOptions, LogLevel, Logger, type LoggerOptions, MCPServer, type MCPServerConstructorOptions, type MCPServerFactory, type MCPServerOptions, MCPServerRuntime, Optional, Prompt, type PromptOptions, Render, Resource, type ResourceOptions, SchemaConstraint, Tool, type ToolOptions, UI, UserEnvs, classToJsonSchema, classToJsonSchemaWithConstraints, createHTTPServer, defaultLogger, getDecoratedMethods, getMethodMetadata, startMCPServer, validateNonEmpty, validatePath, validatePort, validateServiceName, validateUrl };