@tmcp/transport-http 0.5.6 → 0.6.1

package/README.md

@@ -81,6 +81,50 @@ const transport = new HttpTransport(server, {
 });
 ```
 
+### With Custom Context
+
+You can pass custom context data to your MCP server for each request. This is useful for authentication, user information, database connections, etc.
+
+```javascript
+// Define your custom context type
+interface MyContext {
+    userId: string;
+    permissions: string[];
+    database: DatabaseConnection;
+}
+
+// Create server with custom context
+const server = new McpServer(serverInfo, options).withContext<MyContext>();
+
+server.tool(
+    {
+        name: 'get-user-profile',
+        description: 'Get the current user profile',
+    },
+    async () => {
+        // Access custom context in your handler
+        const { userId, database } = server.ctx.custom!;
+        const profile = await database.users.findById(userId);
+
+        return {
+            content: [
+                { type: 'text', text: `User profile: ${JSON.stringify(profile)}` }
+            ],
+        };
+    },
+);
+
+// Create transport (it will be typed to accept your custom context)
+const transport = new HttpTransport(server);
+
+// then in the handler
+const response = await transport.respond(req, {
+	userId,
+	permissions,
+	database: req.locals.db,
+});
+```
+
 ### Session Management
 
 The HTTP transport supports custom session managers for different deployment scenarios:
@@ -154,13 +198,14 @@ interface HttpTransportOptions {
 
 #### Methods
 
-##### `respond(request: Request): Promise<Response | null>`
+##### `respond(request: Request, customContext?: T): Promise<Response | null>`
 
 Processes an HTTP request and returns a Response with Server-Sent Events, or null if the request path doesn't match the configured MCP path.
 
 **Parameters:**
 
 - `request` - A Web API Request object containing the JSON-RPC message
+- `customContext` - Optional custom context data to pass to the MCP server for this request
 
 **Returns:**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmcp/transport-http",
-  "version": "0.5.6",
+  "version": "0.6.1",
   "description": "Transport for TMCP using HTTP",
   "type": "module",
   "main": "src/index.js",
@@ -16,7 +16,7 @@
     "src/**/*"
   ],
   "peerDependencies": {
-    "tmcp": "^1.10.3"
+    "tmcp": "^1.12.2"
   },
   "keywords": [
     "tmcp",
@@ -29,7 +29,7 @@
     "directory": "packages/transport-http"
   },
   "dependencies": {
-    "@tmcp/session-manager": "^0.1.1"
+    "@tmcp/session-manager": "^0.1.2"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.17.1",
@@ -41,7 +41,7 @@
     "vitest": "^3.2.4",
     "@tmcp/adapter-valibot": "^0.1.4",
     "@tmcp/auth": "^0.3.3",
-    "tmcp": "^1.10.3"
+    "tmcp": "^1.12.2"
   },
   "publishConfig": {
     "access": "public"

package/src/index.js

@@ -27,9 +27,13 @@
 
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { InMemorySessionManager } from '@tmcp/session-manager';
+
+/**
+ * @template {Record<string, unknown> | undefined} [TCustom=undefined]
+ */
 export class HttpTransport {
 	/**
-	 * @type {McpServer<any>}
+	 * @type {McpServer<any, TCustom>}
 	 */
 	#server;
 
@@ -57,7 +61,7 @@ export class HttpTransport {
 
 	/**
 	 *
-	 * @param {McpServer<any>} server
+	 * @param {McpServer<any, TCustom>} server
 	 * @param {HttpTransportOptions} [options]
 	 */
 	constructor(server, options) {
@@ -250,8 +254,9 @@ export class HttpTransport {
 	 * @param {string} session_id
 	 * @param {Request} request
 	 * @param {AuthInfo | null} auth_info
+	 * @param {TCustom} [ctx]
 	 */
-	async #handle_post(session_id, request, auth_info) {
+	async #handle_post(session_id, request, auth_info, ctx) {
 		// Check Content-Type header
 		const content_type = request.headers.get('content-type');
 		if (!content_type || !content_type.includes('application/json')) {
@@ -296,6 +301,7 @@ export class HttpTransport {
 						this.#server.receive(body, {
 							sessionId: session_id,
 							auth: auth_info ?? undefined,
+							custom: ctx,
 						}),
 				);
 
@@ -375,9 +381,10 @@ export class HttpTransport {
 	/**
 	 *
 	 * @param {Request} request
+	 * @param {TCustom} [ctx]
 	 * @returns {Promise<Response | null>}
 	 */
-	async respond(request) {
+	async respond(request, ctx) {
 		const url = new URL(request.url);
 
 		/**
@@ -441,7 +448,12 @@ export class HttpTransport {
 		}
 		// Handle POST request - process message and respond through event stream
 		else if (method === 'POST') {
-			response = await this.#handle_post(session_id, request, auth_info);
+			response = await this.#handle_post(
+				session_id,
+				request,
+				auth_info,
+				ctx,
+			);
 		}
 		// Method not supported
 		else {

package/src/types/index.d.ts

@@ -2,11 +2,11 @@ declare module '@tmcp/transport-http' {
 	import type { McpServer } from 'tmcp';
 	import type { OAuth } from '@tmcp/auth';
 	import type { SessionManager } from '@tmcp/session-manager';
-	export class HttpTransport {
+	export class HttpTransport<TCustom extends Record<string, unknown> | undefined = undefined> {
 		
-		constructor(server: McpServer<any>, options?: HttpTransportOptions);
+		constructor(server: McpServer<any, TCustom>, options?: HttpTransportOptions);
 		
-		respond(request: Request): Promise<Response | null>;
+		respond(request: Request, ctx?: TCustom): Promise<Response | null>;
 		#private;
 	}
 	export type CorsConfig = {

package/src/types/index.d.ts.map

@@ -10,6 +10,6 @@
 	"sourcesContent": [
 		null
 	],
-	"mappings": ";;;;cA6BaA,aAAaA",
+	"mappings": ";;;;cAiCaA,aAAaA",
 	"ignoreList": []
 }