@ttoss/http-server-mcp 0.3.0 → 0.3.2

package/dist/index.d.cts

@@ -0,0 +1,61 @@
+import * as _koa_router from '@koa/router';
+import * as koa from 'koa';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { McpServer, McpServer as Server } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { z } from 'zod';
+
+/**
+ * Options for configuring the MCP router
+ */
+interface McpRouterOptions {
+    /**
+     * The HTTP path where the MCP server will be mounted
+     * @default '/mcp'
+     */
+    path?: string;
+    /**
+     * Optional session ID generator for stateful MCP servers
+     * Set to undefined for stateless servers
+     */
+    sessionIdGenerator?: () => string;
+}
+/**
+ * Creates a Koa router configured to handle MCP protocol requests
+ *
+ * @param server - The MCP server instance with registered tools and resources
+ * @param options - Configuration options for the router
+ * @returns A Koa Router instance configured for MCP
+ *
+ * @example
+ * ```typescript
+ * import { App, bodyParser } from '@ttoss/http-server';
+ * import { createMcpRouter, Server as McpServer, z } from '@ttoss/http-server-mcp';
+ *
+ * const mcpServer = new McpServer({
+ *   name: 'my-server',
+ *   version: '1.0.0',
+ * });
+ *
+ * mcpServer.registerTool(
+ *   'hello',
+ *   {
+ *     description: 'Say hello',
+ *     inputSchema: { name: z.string() },
+ *   },
+ *   async ({ name }) => ({
+ *     content: [{ type: 'text', text: `Hello, ${name}!` }],
+ *   })
+ * );
+ *
+ * const app = new App();
+ * app.use(bodyParser());
+ *
+ * const mcpRouter = createMcpRouter(mcpServer);
+ * app.use(mcpRouter.routes());
+ *
+ * app.listen(3000);
+ * ```
+ */
+declare const createMcpRouter: (server: McpServer, options?: McpRouterOptions) => _koa_router.RouterInstance<koa.DefaultState, koa.DefaultContext>;
+
+export { type McpRouterOptions, createMcpRouter };

package/dist/index.js

@@ -0,0 +1,87 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", {
+  value,
+  configurable: true
+});
+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 __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Server: () => import_mcp.McpServer,
+  createMcpRouter: () => createMcpRouter,
+  z: () => import_zod.z
+});
+module.exports = __toCommonJS(index_exports);
+var import_streamableHttp = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+var import_http_server = require("@ttoss/http-server");
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var import_zod = require("zod");
+var createMcpRouter = /* @__PURE__ */__name((server, options = {}) => {
+  const {
+    path = "/mcp",
+    sessionIdGenerator
+  } = options;
+  const transport = new import_streamableHttp.StreamableHTTPServerTransport({
+    sessionIdGenerator,
+    enableJsonResponse: true
+  });
+  server.connect(transport);
+  const router = new import_http_server.Router();
+  router.post(path, async ctx => {
+    try {
+      await transport.handleRequest(ctx.req, ctx.res, ctx.request.body);
+      ctx.respond = false;
+    } catch (error) {
+      if (!ctx.res.headersSent) {
+        ctx.status = 500;
+        ctx.body = {
+          error: error instanceof Error ? error.message : "Internal server error"
+        };
+      }
+    }
+  });
+  router.delete(path, async ctx => {
+    try {
+      await transport.handleRequest(ctx.req, ctx.res, void 0);
+      ctx.respond = false;
+    } catch (error) {
+      if (!ctx.res.headersSent) {
+        ctx.status = 500;
+        ctx.body = {
+          error: error instanceof Error ? error.message : "Internal server error"
+        };
+      }
+    }
+  });
+  return router;
+}, "createMcpRouter");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Server,
+  createMcpRouter,
+  z
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/http-server-mcp",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Model Context Protocol (MCP) server integration for @ttoss/http-server",
   "license": "MIT",
   "author": "ttoss",
@@ -16,6 +16,7 @@
   "exports": {
     ".": {
       "import": "./dist/esm/index.js",
+      "require": "./dist/index.js",
       "types": "./dist/index.d.ts"
     }
   },
@@ -26,7 +27,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
     "zod": "^3.25.76",
-    "@ttoss/http-server": "^0.3.0"
+    "@ttoss/http-server": "^0.3.2"
   },
   "devDependencies": {
     "@types/koa": "^3.0.1",