@karashiiro/mcp 0.1.0 → 0.3.0

package/README.md

@@ -1,3 +1,227 @@
-# mcp
+# @karashiiro/mcp
 
-(WIP) MCP utilities in TypeScript
+Lightweight utilities for serving [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers in TypeScript.
+
+## Installation
+
+```bash
+npm install @karashiiro/mcp @modelcontextprotocol/sdk
+```
+
+### For HTTP transport
+
+If you plan to use HTTP transport, you'll also need Hono:
+
+```bash
+npm install hono @hono/node-server
+```
+
+## Usage
+
+### Stdio Transport
+
+The simplest way to serve an MCP server. Great for CLI tools and local integrations.
+
+```ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { serveStdio } from "@karashiiro/mcp/stdio";
+
+function createServer() {
+  const server = new McpServer({
+    name: "my-server",
+    version: "1.0.0",
+  });
+
+  server.registerTool(
+    "hello",
+    { description: "Says hello" },
+    async () => ({
+      content: [{ type: "text", text: "Hello from MCP!" }],
+    }),
+  );
+
+  return server;
+}
+
+await serveStdio(createServer);
+```
+
+### HTTP Transport
+
+Serve your MCP server over HTTP using the Streamable HTTP transport.
+
+```ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { serveHttp } from "@karashiiro/mcp/http";
+
+function createServer() {
+  const server = new McpServer({
+    name: "my-server",
+    version: "1.0.0",
+  });
+
+  server.registerTool(
+    "hello",
+    { description: "Says hello" },
+    async () => ({
+      content: [{ type: "text", text: "Hello from MCP!" }],
+    }),
+  );
+
+  return server;
+}
+
+const handle = await serveHttp(createServer, {
+  port: 8080,
+  host: "127.0.0.1",
+  endpoint: "/mcp",
+});
+
+// Later, to shut down:
+await handle.close();
+```
+
+#### Stateless vs Stateful Mode
+
+By default, `serveHttp` runs in **stateless mode** where all clients share a single server instance.
+
+For **stateful mode** with per-client sessions, provide the `sessions` option:
+
+```ts
+const handle = await serveHttp(createServer, {
+  port: 8080,
+  sessions: {}, // Enable stateful mode
+});
+```
+
+In stateful mode, `createServer` is called once per client session, allowing each client to have isolated state.
+
+#### Session-Aware Factories
+
+In stateful mode, the factory function receives the session ID as a parameter, enabling session-specific initialization:
+
+```ts
+const handle = await serveHttp(
+  (sessionId) => {
+    console.log(`Creating server for session: ${sessionId}`);
+    return createServer();
+  },
+  {
+    port: 8080,
+    sessions: {},
+  },
+);
+```
+
+#### Async Factories
+
+The factory function can be async, which is useful for initialization that requires async operations:
+
+```ts
+const handle = await serveHttp(
+  async (sessionId) => {
+    // Perform async initialization (e.g., connect to database, load config)
+    await initializeResources(sessionId);
+    return createServer();
+  },
+  {
+    port: 8080,
+    sessions: {},
+  },
+);
+```
+
+#### Custom Session IDs
+
+```ts
+const handle = await serveHttp(createServer, {
+  port: 8080,
+  sessions: {
+    sessionIdGenerator: () => `session-${Date.now()}`,
+  },
+});
+```
+
+#### Legacy SSE Support
+
+For backwards compatibility with older MCP clients that use SSE transport:
+
+```ts
+const handle = await serveHttp(createServer, {
+  port: 8080,
+  sessions: {
+    legacySse: {
+      sseEndpoint: "/sse",        // default: "/sse"
+      messagesEndpoint: "/messages", // default: "/messages"
+    },
+  },
+});
+```
+
+## Entry Points
+
+This package provides multiple entry points for optimal bundle size:
+
+| Entry Point | Description | Requires Hono |
+|-------------|-------------|---------------|
+| `@karashiiro/mcp` | Everything (re-exports all) | Yes |
+| `@karashiiro/mcp/stdio` | Stdio transport only | No |
+| `@karashiiro/mcp/http` | HTTP transport only | Yes |
+
+If you only need stdio transport, import from `@karashiiro/mcp/stdio` to avoid bundling Hono.
+
+## API Reference
+
+### Factory Types
+
+The library provides two factory types for type-safe server creation:
+
+```ts
+// For stateless mode (serveStdio and serveHttp without sessions)
+type StatelessServerFactory = () => McpServer | Promise<McpServer>;
+
+// For stateful mode (serveHttp with sessions)
+type StatefulServerFactory = (sessionId: string) => McpServer | Promise<McpServer>;
+```
+
+Both factory types support async initialization by returning a `Promise<McpServer>`.
+
+### `serveStdio(serverFactory)`
+
+Serves an MCP server over stdin/stdout.
+
+- `serverFactory: StatelessServerFactory` - Factory function that creates a single server instance
+- Returns: `Promise<ServerHandle>`
+
+### `serveHttp(serverFactory, options?)` (stateless)
+
+Serves an MCP server over HTTP in stateless mode.
+
+- `serverFactory: StatelessServerFactory` - Factory function called once, creates a shared server
+- `options.port` - Port to listen on (default: `8080`)
+- `options.host` - Host to bind to (default: `"127.0.0.1"`)
+- `options.endpoint` - MCP endpoint path (default: `"/mcp"`)
+- Returns: `Promise<ServerHandle>`
+
+### `serveHttp(serverFactory, options)` (stateful)
+
+Serves an MCP server over HTTP in stateful mode with per-client sessions.
+
+- `serverFactory: StatefulServerFactory` - Factory function called per session with the session ID
+- `options.port` - Port to listen on (default: `8080`)
+- `options.host` - Host to bind to (default: `"127.0.0.1"`)
+- `options.endpoint` - MCP endpoint path (default: `"/mcp"`)
+- `options.sessions` - **Required** to enable stateful mode
+- `options.sessions.sessionIdGenerator` - Custom session ID generator function
+- `options.sessions.legacySse` - Enable legacy SSE transport endpoints
+- Returns: `Promise<ServerHandle>`
+
+### `ServerHandle`
+
+Handle for controlling the server lifecycle.
+
+- `close(): Promise<void>` - Gracefully shut down the server
+
+## License
+
+UNLICENSED

package/dist/http.d.ts

@@ -0,0 +1,73 @@
+import type { ServerHandle, StatelessServerFactory, StatefulServerFactory } from "./types.js";
+export type { ServerHandle, StatelessServerFactory, StatefulServerFactory, } from "./types.js";
+export type { ServerFactory } from "./types.js";
+/**
+ * Options for legacy SSE transport compatibility.
+ * @deprecated SSE transport is deprecated in favor of Streamable HTTP.
+ */
+export interface LegacySseOptions {
+    /** Endpoint for SSE stream. Defaults to "/sse". */
+    sseEndpoint?: string;
+    /** Endpoint for messages. Defaults to "/messages". */
+    messagesEndpoint?: string;
+}
+export interface HttpServerSessionOptions {
+    sessionIdGenerator?: () => string;
+    /**
+     * Enable legacy SSE transport compatibility.
+     * When provided, adds /sse and /messages endpoints for older clients.
+     * @deprecated SSE transport is deprecated in favor of Streamable HTTP.
+     */
+    legacySse?: LegacySseOptions;
+}
+/**
+ * Base HTTP server options without session configuration.
+ */
+export interface HttpServerOptionsBase {
+    port: number;
+    host: string;
+    endpoint: string;
+}
+/**
+ * HTTP server options for stateless mode (no sessions).
+ */
+export interface HttpServerStatelessOptions extends HttpServerOptionsBase {
+    sessions?: undefined;
+}
+/**
+ * HTTP server options for stateful mode (with sessions).
+ */
+export interface HttpServerStatefulOptions extends HttpServerOptionsBase {
+    sessions: HttpServerSessionOptions;
+}
+/**
+ * Combined HTTP server options type.
+ */
+export type HttpServerOptions = HttpServerStatelessOptions | HttpServerStatefulOptions;
+/**
+ * Serve an MCP server over HTTP in stateless mode.
+ *
+ * In stateless mode, the factory is called once and all clients share the same server instance.
+ * The factory receives no parameters.
+ *
+ * @param serverFactory - Factory function that creates a single shared McpServer instance.
+ * @param options - Server configuration options (without sessions).
+ * @returns A handle to control the server lifecycle.
+ */
+export declare function serveHttp(serverFactory: StatelessServerFactory, options?: Partial<Omit<HttpServerOptionsBase, "sessions">> & {
+    sessions?: undefined;
+}): Promise<ServerHandle>;
+/**
+ * Serve an MCP server over HTTP in stateful mode with per-client sessions.
+ *
+ * In stateful mode, the factory is called once per client session, receiving the session ID.
+ * This allows each client to have isolated state.
+ *
+ * @param serverFactory - Factory function that creates McpServer instances per session.
+ * @param options - Server configuration options with sessions enabled.
+ * @returns A handle to control the server lifecycle.
+ */
+export declare function serveHttp(serverFactory: StatefulServerFactory, options: Partial<HttpServerOptionsBase> & {
+    sessions: HttpServerSessionOptions;
+}): Promise<ServerHandle>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,qBAAqB;IACvE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACtE,QAAQ,EAAE,wBAAwB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,0BAA0B,GAC1B,yBAAyB,CAAC;AAqD9B;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,aAAa,EAAE,sBAAsB,EACrC,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC,GAAG;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACA,OAAO,CAAC,YAAY,CAAC,CAAC;AAEzB;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,aAAa,EAAE,qBAAqB,EACpC,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG;IACxC,QAAQ,EAAE,wBAAwB,CAAC;CACpC,GACA,OAAO,CAAC,YAAY,CAAC,CAAC"}

package/dist/http.js

@@ -0,0 +1,230 @@
+import { serve } from "@hono/node-server";
+import { RESPONSE_ALREADY_SENT } from "@hono/node-server/utils/response";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { v4 as uuidv4 } from "uuid";
+import { InMemoryEventStore } from "./event-store.js";
+const defaultOptions = Object.freeze({
+    port: 8080,
+    host: "127.0.0.1",
+    endpoint: "/mcp",
+    sessions: undefined,
+});
+/**
+ * Helper to create a closeable handle from a node server.
+ */
+function createHandle(server) {
+    return {
+        close: () => new Promise((resolve, reject) => {
+            server.close((err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        }),
+    };
+}
+// Implementation signature (accepts both)
+export async function serveHttp(serverFactory, options = {}) {
+    const mergedOptions = {
+        ...defaultOptions,
+        ...options,
+    };
+    if (mergedOptions.sessions) {
+        return serveHttpStateful(serverFactory, mergedOptions);
+    }
+    else {
+        return serveHttpStateless(serverFactory, mergedOptions);
+    }
+}
+/**
+ * Stateless mode: single server instance, single transport, no session tracking.
+ */
+async function serveHttpStateless(serverFactory, options) {
+    // Call factory ONCE to get the single server instance (no sessionId in stateless mode)
+    const server = await serverFactory();
+    // Create the transport (no session ID generator = stateless)
+    const transport = new WebStandardStreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+    });
+    // Create the Hono app
+    const app = new Hono();
+    addCors(app);
+    // MCP endpoint
+    app.all(options.endpoint, (c) => transport.handleRequest(c.req.raw));
+    await server.connect(transport);
+    const httpServer = serve({
+        fetch: app.fetch,
+        port: options.port,
+        hostname: options.host,
+    });
+    return createHandle(httpServer);
+}
+/**
+ * Stateful mode: per-session servers, transports, and event stores.
+ */
+function serveHttpStateful(serverFactory, options) {
+    const sessions = new Map();
+    const sessionIdGenerator = options.sessions.sessionIdGenerator ?? uuidv4;
+    // Legacy SSE options
+    const legacySse = options.sessions?.legacySse;
+    const sseEndpoint = legacySse?.sseEndpoint ?? "/sse";
+    const messagesEndpoint = legacySse?.messagesEndpoint ?? "/messages";
+    const app = new Hono();
+    addCors(app);
+    // Main MCP endpoint (Streamable HTTP)
+    app.all(options.endpoint, async (c) => {
+        const sessionId = c.req.header("mcp-session-id");
+        // Clone the request so we can read the body without consuming it
+        const rawRequest = c.req.raw;
+        const bodyText = await rawRequest.text();
+        let body = null;
+        try {
+            body = bodyText ? JSON.parse(bodyText) : null;
+        }
+        catch {
+            // Invalid JSON - body stays null
+        }
+        // Helper to recreate request with body (since we consumed it)
+        const recreateRequest = () => new Request(rawRequest.url, {
+            method: rawRequest.method,
+            headers: rawRequest.headers,
+            body: bodyText || undefined,
+        });
+        // New session (initialize request without session ID)
+        if (!sessionId && body && isInitializeRequest(body)) {
+            // Generate session ID upfront so we can pass it to the factory
+            const sid = sessionIdGenerator();
+            // Create server with session ID (supports async factories)
+            const server = await serverFactory(sid);
+            const eventStore = new InMemoryEventStore();
+            const transport = new WebStandardStreamableHTTPServerTransport({
+                // Use our pre-generated session ID
+                sessionIdGenerator: () => sid,
+                eventStore,
+                onsessioninitialized: () => {
+                    // Server already created above, just store the session state
+                    const session = {
+                        type: "streamable-http",
+                        transport,
+                        server,
+                        eventStore,
+                    };
+                    sessions.set(sid, session);
+                },
+            });
+            // Connect server to transport before handling the request
+            await server.connect(transport);
+            transport.onclose = () => {
+                sessions.delete(sid);
+            };
+            return transport.handleRequest(recreateRequest());
+        }
+        // Existing session
+        if (sessionId) {
+            const session = sessions.get(sessionId);
+            if (!session) {
+                return c.text("Session not found", 404);
+            }
+            // Validate transport type matches endpoint
+            if (session.type !== "streamable-http") {
+                return c.json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32000,
+                        message: "Bad Request: Session exists but uses a different transport protocol",
+                    },
+                    id: null,
+                }, 400);
+            }
+            return session.transport.handleRequest(recreateRequest());
+        }
+        // Invalid request (no session ID, not an initialize request)
+        return c.text("Bad request - missing session ID", 400);
+    });
+    // Legacy SSE endpoints (only if enabled)
+    if (legacySse) {
+        // GET /sse - Establish SSE stream
+        app.get(sseEndpoint, async (c) => {
+            const { outgoing } = c.env;
+            // Create SSE transport with messages endpoint
+            const transport = new SSEServerTransport(messagesEndpoint, outgoing);
+            // Create server with session ID (supports async factories)
+            const server = await serverFactory(transport.sessionId);
+            // Store session
+            const session = {
+                type: "sse",
+                transport,
+                server,
+            };
+            sessions.set(transport.sessionId, session);
+            // Cleanup on close
+            transport.onclose = () => {
+                sessions.delete(transport.sessionId);
+            };
+            // Connect and start
+            await server.connect(transport);
+            // Signal to Hono that we've handled the response directly
+            return RESPONSE_ALREADY_SENT;
+        });
+        // POST /messages - Handle messages for SSE sessions
+        app.post(messagesEndpoint, async (c) => {
+            const sessionId = c.req.query("sessionId");
+            if (!sessionId) {
+                return c.text("Missing sessionId query parameter", 400);
+            }
+            const session = sessions.get(sessionId);
+            if (!session) {
+                return c.text("Session not found", 404);
+            }
+            // Validate transport type matches endpoint
+            if (session.type !== "sse") {
+                return c.json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32000,
+                        message: "Bad Request: Session exists but uses a different transport protocol",
+                    },
+                    id: null,
+                }, 400);
+            }
+            const { incoming, outgoing } = c.env;
+            // Parse body for SSEServerTransport
+            const bodyText = await c.req.text();
+            let parsedBody = null;
+            try {
+                parsedBody = bodyText ? JSON.parse(bodyText) : null;
+            }
+            catch {
+                // Let handlePostMessage handle the error
+            }
+            await session.transport.handlePostMessage(incoming, outgoing, parsedBody);
+            return RESPONSE_ALREADY_SENT;
+        });
+    }
+    const httpServer = serve({
+        fetch: app.fetch,
+        port: options.port,
+        hostname: options.host,
+    });
+    return createHandle(httpServer);
+}
+function addCors(app) {
+    // Enable CORS for all origins
+    app.use("*", cors({
+        origin: "*",
+        allowMethods: ["GET", "POST", "DELETE", "OPTIONS"],
+        allowHeaders: [
+            "Content-Type",
+            "mcp-session-id",
+            "Last-Event-ID",
+            "mcp-protocol-version",
+        ],
+        exposeHeaders: ["mcp-session-id", "mcp-protocol-version"],
+    }));
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,29 +1,3 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export interface HttpServerSessionOptions {
-    sessionIdGenerator?: () => string;
-}
-export interface HttpServerOptions {
-    port: number;
-    host: string;
-    endpoint: string;
-    sessions?: HttpServerSessionOptions | undefined;
-}
-/**
- * Handle returned by serveHttp for controlling the server lifecycle.
- */
-export interface HttpServerHandle {
-    /** Close the HTTP server and stop accepting new connections. */
-    close: () => Promise<void>;
-}
-/**
- * Serve an MCP server over HTTP.
- *
- * @param serverFactory - Factory function that creates McpServer instances.
- *   In stateless mode, called once. In stateful mode, called per session.
- * @param options - Server configuration options.
- *   If `sessions` is provided, runs in stateful mode with per-session servers.
- *   If `sessions` is undefined, runs in stateless mode with a single server.
- * @returns A handle to control the server lifecycle.
- */
-export declare function serveHttp(serverFactory: () => McpServer, options?: Partial<HttpServerOptions>): Promise<HttpServerHandle>;
+export * from "./http.js";
+export * from "./stdio.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAiCD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,aAAa,EAAE,MAAM,SAAS,EAC9B,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -1,152 +1,6 @@
-import { serve } from "@hono/node-server";
-import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
-import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
-import { Hono } from "hono";
-import { cors } from "hono/cors";
-import { v4 as uuidv4 } from "uuid";
-import { InMemoryEventStore } from "./event-store.js";
-const defaultOptions = Object.freeze({
-    port: 8080,
-    host: "127.0.0.1",
-    endpoint: "/mcp",
-    sessions: undefined,
-});
-/**
- * Helper to create a closeable handle from a node server.
- */
-function createHandle(server) {
-    return {
-        close: () => new Promise((resolve, reject) => {
-            server.close((err) => {
-                if (err)
-                    reject(err);
-                else
-                    resolve();
-            });
-        }),
-    };
-}
-/**
- * Serve an MCP server over HTTP.
- *
- * @param serverFactory - Factory function that creates McpServer instances.
- *   In stateless mode, called once. In stateful mode, called per session.
- * @param options - Server configuration options.
- *   If `sessions` is provided, runs in stateful mode with per-session servers.
- *   If `sessions` is undefined, runs in stateless mode with a single server.
- * @returns A handle to control the server lifecycle.
- */
-export async function serveHttp(serverFactory, options = {}) {
-    const mergedOptions = {
-        ...defaultOptions,
-        ...options,
-    };
-    if (mergedOptions.sessions) {
-        return serveHttpStateful(serverFactory, mergedOptions);
-    }
-    else {
-        return serveHttpStateless(serverFactory, mergedOptions);
-    }
-}
-/**
- * Stateless mode: single server instance, single transport, no session tracking.
- */
-async function serveHttpStateless(serverFactory, options) {
-    // Call factory ONCE to get the single server instance
-    const server = serverFactory();
-    // Create the transport (no session ID generator = stateless)
-    const transport = new WebStandardStreamableHTTPServerTransport({
-        sessionIdGenerator: undefined,
-    });
-    // Create the Hono app
-    const app = new Hono();
-    addCors(app);
-    // MCP endpoint
-    app.all(options.endpoint, (c) => transport.handleRequest(c.req.raw));
-    await server.connect(transport);
-    const httpServer = serve({
-        fetch: app.fetch,
-        port: options.port,
-        hostname: options.host,
-    });
-    return createHandle(httpServer);
-}
-/**
- * Stateful mode: per-session servers, transports, and event stores.
- */
-function serveHttpStateful(serverFactory, options) {
-    const sessions = new Map();
-    const sessionIdGenerator = options.sessions?.sessionIdGenerator ?? uuidv4;
-    const app = new Hono();
-    addCors(app);
-    app.all(options.endpoint, async (c) => {
-        const sessionId = c.req.header("mcp-session-id");
-        // Clone the request so we can read the body without consuming it
-        const rawRequest = c.req.raw;
-        const bodyText = await rawRequest.text();
-        let body = null;
-        try {
-            body = bodyText ? JSON.parse(bodyText) : null;
-        }
-        catch {
-            // Invalid JSON - body stays null
-        }
-        // Helper to recreate request with body (since we consumed it)
-        const recreateRequest = () => new Request(rawRequest.url, {
-            method: rawRequest.method,
-            headers: rawRequest.headers,
-            body: bodyText || undefined,
-        });
-        // New session (initialize request without session ID)
-        if (!sessionId && body && isInitializeRequest(body)) {
-            const eventStore = new InMemoryEventStore();
-            const transport = new WebStandardStreamableHTTPServerTransport({
-                sessionIdGenerator,
-                eventStore,
-                onsessioninitialized: (sid) => {
-                    // Factory called per session!
-                    const server = serverFactory();
-                    sessions.set(sid, { transport, server, eventStore });
-                    server.connect(transport);
-                },
-            });
-            transport.onclose = () => {
-                if (transport.sessionId) {
-                    sessions.delete(transport.sessionId);
-                }
-            };
-            return transport.handleRequest(recreateRequest());
-        }
-        // Existing session
-        if (sessionId) {
-            const session = sessions.get(sessionId);
-            if (!session) {
-                return c.text("Session not found", 404);
-            }
-            return session.transport.handleRequest(recreateRequest());
-        }
-        // Invalid request (no session ID, not an initialize request)
-        return c.text("Bad request - missing session ID", 400);
-    });
-    const httpServer = serve({
-        fetch: app.fetch,
-        port: options.port,
-        hostname: options.host,
-    });
-    return createHandle(httpServer);
-}
-function addCors(app) {
-    // Enable CORS for all origins
-    app.use("*", cors({
-        origin: "*",
-        allowMethods: ["GET", "POST", "DELETE", "OPTIONS"],
-        allowHeaders: [
-            "Content-Type",
-            "mcp-session-id",
-            "Last-Event-ID",
-            "mcp-protocol-version",
-        ],
-        exposeHeaders: ["mcp-session-id", "mcp-protocol-version"],
-    }));
-}
+// Re-export everything from both modules for convenience.
+// Note: Importing from this entry point will load Hono dependencies.
+// For stdio-only usage without Hono, import from "@karashiiro/mcp/stdio" instead.
+export * from "./http.js";
+export * from "./stdio.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,qEAAqE;AACrE,kFAAkF;AAElF,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/stdio.d.ts

@@ -0,0 +1,13 @@
+import type { ServerHandle, StatelessServerFactory } from "./types.js";
+export type { ServerHandle, StatelessServerFactory } from "./types.js";
+export type { ServerFactory } from "./types.js";
+/**
+ * Serve an MCP server over stdio (stdin/stdout).
+ *
+ * @param serverFactory - Factory function that creates an McpServer instance.
+ *   Called once with no parameters (stdio is always single-session).
+ *   Can return a Promise for async initialization.
+ * @returns A handle to control the server lifecycle.
+ */
+export declare function serveStdio(serverFactory: StatelessServerFactory): Promise<ServerHandle>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEvE,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGvE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,aAAa,EAAE,sBAAsB,GACpC,OAAO,CAAC,YAAY,CAAC,CA4BvB"}

package/dist/stdio.js

@@ -0,0 +1,33 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+/**
+ * Serve an MCP server over stdio (stdin/stdout).
+ *
+ * @param serverFactory - Factory function that creates an McpServer instance.
+ *   Called once with no parameters (stdio is always single-session).
+ *   Can return a Promise for async initialization.
+ * @returns A handle to control the server lifecycle.
+ */
+export async function serveStdio(serverFactory) {
+    const server = await serverFactory();
+    const transport = new StdioServerTransport();
+    // Set up the closed promise before connecting
+    let resolveClose;
+    const closedPromise = new Promise((resolve) => {
+        resolveClose = resolve;
+    });
+    transport.onclose = () => {
+        resolveClose();
+    };
+    // connect() automatically calls transport.start() for stdio
+    await server.connect(transport);
+    let closePromise;
+    return {
+        close: () => {
+            if (!closePromise) {
+                closePromise = transport.close().then(() => closedPromise);
+            }
+            return closePromise;
+        },
+    };
+}
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAQjF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAAqC,EACd;IACvB,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;IAErC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,8CAA8C;IAC9C,IAAI,YAAwB,CAAC;IAC7B,MAAM,aAAa,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACnD,YAAY,GAAG,OAAO,CAAC;IAAA,CACxB,CAAC,CAAC;IAEH,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;QACxB,YAAY,EAAE,CAAC;IAAA,CAChB,CAAC;IAEF,4DAA4D;IAC5D,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,YAAuC,CAAC;IAE5C,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO,YAAY,CAAC;QAAA,CACrB;KACF,CAAC;AAAA,CACH"}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Handle returned by serve functions for controlling the server lifecycle.
+ */
+export interface ServerHandle {
+    /** Close the server and stop accepting new connections. */
+    close: () => Promise<void>;
+}
+/**
+ * Factory function for stateless mode (no session ID).
+ * Used by serveStdio and serveHttp without sessions.
+ */
+export type StatelessServerFactory = () => McpServer | Promise<McpServer>;
+/**
+ * Factory function for stateful mode (receives session ID).
+ * Used by serveHttp with sessions enabled.
+ */
+export type StatefulServerFactory = (sessionId: string) => McpServer | Promise<McpServer>;
+/**
+ * Union type for all server factory signatures.
+ * @deprecated Prefer using StatelessServerFactory or StatefulServerFactory directly.
+ */
+export type ServerFactory = (sessionId?: string) => McpServer | Promise<McpServer>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,SAAS,EAAE,MAAM,KACd,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAEpC;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,SAAS,CAAC,EAAE,MAAM,KACf,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@karashiiro/mcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "",
   "main": "dist/index.js",
   "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./stdio": "./dist/stdio.js",
+    "./http": "./dist/http.js"
+  },
   "files": [
     "dist"
   ],
@@ -12,26 +17,42 @@
   "license": "UNLICENSED",
   "devDependencies": {
     "@eslint/js": "^9.39.2",
+    "@hono/node-server": "^1.19.8",
+    "@modelcontextprotocol/sdk": "^1.25.2",
     "@typescript/native-preview": "7.0.0-dev.20260113.1",
     "eslint": "^9.39.2",
+    "eventsource": "^4.1.0",
     "get-port": "^7.1.0",
     "globals": "^17.0.0",
+    "hono": "^4.11.4",
     "jiti": "^2.6.1",
     "prettier": "^3.7.4",
     "typescript-eslint": "^8.53.0",
-    "vitest": "^4.0.17"
+    "vitest": "^4.0.17",
+    "zod": "^4.3.5"
   },
-  "dependencies": {
+  "peerDependencies": {
     "@hono/node-server": "^1.19.8",
     "@modelcontextprotocol/sdk": "^1.25.2",
-    "hono": "^4.11.4",
-    "uuid": "^13.0.0",
-    "zod": "^4.3.5"
+    "hono": "^4.11.4"
+  },
+  "peerDependenciesMeta": {
+    "@hono/node-server": {
+      "optional": true
+    },
+    "hono": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "uuid": "^13.0.0"
   },
   "scripts": {
     "build": "tsgo -p tsconfig.dist.json",
-    "test": "vitest",
+    "test": "vitest --run",
     "lint": "eslint . --ext .ts",
-    "format": "prettier --write ."
+    "format": "prettier --write .",
+    "typecheck": "tsgo --noEmit",
+    "check": "pnpm typecheck && pnpm lint && pnpm test"
   }
 }