@karashiiro/my-cool-proxy 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kara
+
+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,325 @@
+# my-cool-proxy
+
+MCP gateway server that lets you call multiple MCP servers from Lua scripts.
+
+## Overview
+
+This proxy acts as a gateway between AI agents and multiple MCP (Model Context Protocol) servers. Instead of connecting to each MCP server individually, agents connect to this single proxy and gain access to all configured servers through a unified interface.
+
+**Progressive Tool Discovery:** Agents start with zero knowledge about what servers or tools are available. They build context progressively:
+
+1. Call `list-servers` - The agent's context now includes names and descriptions of all available MCP servers (e.g., "github", "slack", "database")
+2. Call `list-server-tools(server_name)` - The agent's context expands to include all tool names and descriptions for that specific server
+3. Call `tool-details(server_name, tool_name)` - The agent's context now has complete parameter schemas, return types (if available), and usage examples for a specific tool
+4. Call `execute(lua_script)` - With full context, the agent can write Lua scripts that call the discovered tools
+
+Rather than loading all tools and tool descriptions into the context upfront, this defers loading tools until the agent determines those tools are needed.
+
+**Tool Chaining with Lua:** Once an agent knows what tools exist, they can compose complex multi-step workflows in a single `execute()` call. The Lua runtime provides access to all discovered servers as globals, with tools callable as async functions.
+
+**Sequential tool chaining:**
+
+```lua
+local raw_data = api_server.fetch({ id = 123 }):await()
+local processed = processor.transform({ input = raw_data }):await()
+result(processed)
+```
+
+**Conditional logic:**
+
+```lua
+local status = checker.validate({}):await()
+if status.ok then
+  result(processor.run({}):await())
+else
+  result(error_handler.notify({ error = status.message }):await())
+end
+```
+
+**Iteration with loops:**
+
+```lua
+local results = {}
+for i = 1, 5 do
+  results[i] = worker.process({ index = i }):await()
+end
+result({ total = #results, data = results })
+```
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pnpm install
+```
+
+### 2. Configure
+
+Create the config directory and copy the example config:
+
+```bash
+# Linux
+mkdir -p ~/.config/my-cool-proxy
+cp config.example.json ~/.config/my-cool-proxy/config.json
+
+# macOS
+mkdir -p ~/Library/Preferences/my-cool-proxy
+cp config.example.json ~/Library/Preferences/my-cool-proxy/config.json
+
+# Windows (PowerShell)
+mkdir "$env:APPDATA\my-cool-proxy\Config"
+Copy-Item config.example.json "$env:APPDATA\my-cool-proxy\Config\config.json"
+```
+
+Edit `config.json` to add your MCP servers (see [CONFIG.md](./CONFIG.md) for all options):
+
+```json
+{
+  "port": 3000,
+  "host": "localhost",
+  "mcpClients": {
+    "my-server": {
+      "type": "http",
+      "url": "https://example.com/mcp"
+    }
+  }
+}
+```
+
+> **Tip:** Run `node dist/index.js --config-path` to see exactly where your config should be located.
+
+### 3. Run
+
+```bash
+pnpm dev
+```
+
+### 4. Connect
+
+Add to your MCP client config (e.g., Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "my-cool-proxy": {
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+```
+
+### 5. Use It
+
+The proxy exposes these tools:
+
+- `execute` - Run Lua scripts that can call your configured MCP servers
+- `list-servers` - See available servers
+- `list-server-tools` - See tools for a server
+- `tool-details` - Get full tool documentation
+
+Example Lua script:
+
+```lua
+-- Call a tool and return the result directly
+result(my_server.some_tool({ arg = "value" }):await())
+
+-- Or store in a variable first if you need to process it
+local data = my_server.some_tool({ arg = "value" }):await()
+result({ processed = data.something })
+```
+
+## MCP Client Transport Types
+
+## Running the Gateway
+
+The gateway supports two modes for how it exposes itself to MCP clients.
+
+### HTTP Mode (Default)
+
+Run the gateway as an HTTP server that clients connect to remotely:
+
+**Configure** - Set `transport: "http"` in config.json (or omit for default):
+
+```json
+{
+  "port": 3000,
+  "host": "localhost",
+  "transport": "http",
+  "mcpClients": { ... }
+}
+```
+
+**Run:**
+
+```bash
+pnpm dev
+# or for production:
+pnpm build && node dist/index.js
+```
+
+**Connect from MCP client:**
+
+```json
+{
+  "mcpServers": {
+    "my-cool-proxy": {
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+```
+
+### Stdio Mode
+
+Run the gateway as a stdio-based MCP server that clients launch directly. This is ideal when:
+
+- You want the MCP client (e.g., Claude Desktop) to manage the gateway lifecycle
+- You're running everything locally and don't need a persistent server
+- You prefer simpler deployment without managing an HTTP server
+
+**Key differences from HTTP mode:**
+
+- Single session only (no multi-client support)
+- All upstream MCP clients initialize at startup (not lazily)
+- Must build before running (`pnpm dev` won't work - stdout is used for MCP protocol)
+
+#### 1. Configure
+
+Create your config file with `transport: "stdio"`:
+
+```bash
+# Linux
+mkdir -p ~/.config/my-cool-proxy
+# macOS
+mkdir -p ~/Library/Preferences/my-cool-proxy
+# Windows (PowerShell)
+mkdir "$env:APPDATA\my-cool-proxy\Config"
+```
+
+Add your config (port and host are ignored in stdio mode):
+
+```json
+{
+  "transport": "stdio",
+  "mcpClients": {
+    "filesystem": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-everything"]
+    }
+  }
+}
+```
+
+> **Tip:** Run `node dist/index.js --config-path` to see exactly where your config should be located.
+
+#### 2. Build
+
+Stdio mode requires a compiled build:
+
+```bash
+pnpm install
+pnpm build
+```
+
+#### 3. Connect from MCP Client
+
+Add to your MCP client config (e.g., Claude Desktop's `claude_desktop_config.json`):
+
+**macOS/Linux:**
+
+```json
+{
+  "mcpServers": {
+    "my-cool-proxy": {
+      "command": "node",
+      "args": ["/absolute/path/to/my-cool-proxy/dist/index.js"]
+    }
+  }
+}
+```
+
+**Windows:**
+
+```json
+{
+  "mcpServers": {
+    "my-cool-proxy": {
+      "command": "node",
+      "args": ["C:\\Users\\yourname\\path\\to\\my-cool-proxy\\dist\\index.js"]
+    }
+  }
+}
+```
+
+#### 4. Restart Your MCP Client
+
+Restart Claude Desktop (or your MCP client) to pick up the new config. The gateway will start automatically when you begin a conversation.
+
+#### Troubleshooting Stdio Mode
+
+**Gateway not starting?**
+
+- Check your MCP client's logs for error messages
+- Verify the path to `dist/index.js` is correct and absolute
+- Ensure you ran `pnpm build` after any code changes
+
+**Config not found?**
+
+- Run `node dist/index.js --config-path` from the project directory to see expected location
+- Or set `CONFIG_PATH` environment variable to override:
+
+```json
+{
+  "mcpServers": {
+    "my-cool-proxy": {
+      "command": "node",
+      "args": ["path/to/my-cool-proxy/dist/index.js"],
+      "env": {
+        "CONFIG_PATH": "/path/to/your/config.json"
+      }
+    }
+  }
+}
+```
+
+**Upstream servers failing to connect?**
+
+- All configured MCP clients must connect successfully at startup in stdio mode
+- Check that commands in your config are correct and dependencies are installed
+- Try running the upstream servers individually first to verify they work
+
+## MCP Client Transport Types
+
+**HTTP** - Connect to remote MCP servers:
+
+```json
+{
+  "type": "http",
+  "url": "https://api.example.com/mcp",
+  "headers": {
+    "Authorization": "Bearer token"
+  }
+}
+```
+
+**Stdio** - Launch local MCP servers:
+
+```json
+{
+  "type": "stdio",
+  "command": "npx",
+  "args": ["-y", "@modelcontextprotocol/server-everything"]
+}
+```
+
+## Documentation
+
+See [CONFIG.md](./CONFIG.md) for full configuration reference.
+
+## Testing
+
+```bash
+pnpm test
+```

package/bin/my-cool-proxy.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/index.js";

package/dist/container/binding-map.d.ts

@@ -0,0 +1,25 @@
+import type { ILuaRuntime, IMCPClientManager, ILogger, ServerConfig, IShutdownHandler, ICapabilityStore, IServerInfoPreloader } from "../types/interfaces.js";
+import type { MCPGatewayServer } from "../mcp/gateway-server.js";
+import type { ToolDiscoveryService } from "../mcp/tool-discovery-service.js";
+import type { ResourceAggregationService } from "../mcp/resource-aggregation-service.js";
+import type { PromptAggregationService } from "../mcp/prompt-aggregation-service.js";
+import type { MCPFormatterService } from "../mcp/mcp-formatter-service.js";
+import type { ITool } from "../tools/base-tool.js";
+import type { IToolRegistry } from "../tools/tool-registry.js";
+export interface ContainerBindingMap {
+    ServerConfig: ServerConfig;
+    Logger: ILogger;
+    LuaRuntime: ILuaRuntime;
+    MCPClientManager: IMCPClientManager;
+    MCPFormatterService: MCPFormatterService;
+    ToolDiscoveryService: ToolDiscoveryService;
+    ResourceAggregationService: ResourceAggregationService;
+    PromptAggregationService: PromptAggregationService;
+    MCPGatewayServer: MCPGatewayServer;
+    ShutdownHandler: IShutdownHandler;
+    Tool: ITool;
+    ToolRegistry: IToolRegistry;
+    CapabilityStore: ICapabilityStore;
+    ServerInfoPreloader: IServerInfoPreloader;
+}
+//# sourceMappingURL=binding-map.d.ts.map

package/dist/container/binding-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-map.d.ts","sourceRoot":"","sources":["../../src/container/binding-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACzF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/D,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,WAAW,CAAC;IACxB,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,0BAA0B,EAAE,0BAA0B,CAAC;IACvD,wBAAwB,EAAE,wBAAwB,CAAC;IACnD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,EAAE,gBAAgB,CAAC;IAClC,IAAI,EAAE,KAAK,CAAC;IACZ,YAAY,EAAE,aAAa,CAAC;IAC5B,eAAe,EAAE,gBAAgB,CAAC;IAClC,mBAAmB,EAAE,oBAAoB,CAAC;CAC3C"}

package/dist/container/binding-map.js

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

package/dist/container/binding-map.js.map

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

package/dist/container/decorators.d.ts

@@ -0,0 +1,5 @@
+import type { TypedInject, TypedMultiInject } from "@inversifyjs/strongly-typed";
+import type { ContainerBindingMap } from "./binding-map.js";
+export declare const $inject: TypedInject<ContainerBindingMap>;
+export declare const $multiInject: TypedMultiInject<ContainerBindingMap>;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/container/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/container/decorators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAkB5D,eAAO,MAAM,OAAO,kCAA6C,CAAC;AAkBlE,eAAO,MAAM,YAAY,uCAC6B,CAAC"}

package/dist/container/decorators.js

@@ -0,0 +1,4 @@
+import { inject, multiInject } from "inversify";
+export const $inject = inject;
+export const $multiInject = multiInject;
+//# sourceMappingURL=decorators.js.map

package/dist/container/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/container/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAuBhD,MAAM,CAAC,MAAM,OAAO,GAAG,MAA0C,CAAC;AAkBlE,MAAM,CAAC,MAAM,YAAY,GACvB,WAAoD,CAAC"}

package/dist/container/inversify.config.d.ts

@@ -0,0 +1,6 @@
+import "reflect-metadata";
+import type { TypedContainer } from "@inversifyjs/strongly-typed";
+import type { ContainerBindingMap } from "./binding-map.js";
+import type { ServerConfig } from "../types/interfaces.js";
+export declare function createContainer(config: ServerConfig): TypedContainer<ContainerBindingMap>;
+//# sourceMappingURL=inversify.config.d.ts.map

package/dist/container/inversify.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inversify.config.d.ts","sourceRoot":"","sources":["../../src/container/inversify.config.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAIV,YAAY,EAIb,MAAM,wBAAwB,CAAC;AAsBhC,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,GACnB,cAAc,CAAC,mBAAmB,CAAC,CAuFrC"}

package/dist/container/inversify.config.js

@@ -0,0 +1,85 @@
+import "reflect-metadata";
+import { Container } from "inversify";
+import { TYPES } from "../types/index.js";
+import { WasmoonRuntime } from "../lua/runtime.js";
+import { MCPClientManager } from "../mcp/client-manager.js";
+import { ConsoleLogger } from "../utils/logger.js";
+import { MCPGatewayServer } from "../mcp/gateway-server.js";
+import { ToolDiscoveryService } from "../mcp/tool-discovery-service.js";
+import { ResourceAggregationService } from "../mcp/resource-aggregation-service.js";
+import { PromptAggregationService } from "../mcp/prompt-aggregation-service.js";
+import { MCPFormatterService } from "../mcp/mcp-formatter-service.js";
+import { ShutdownHandler } from "../handlers/shutdown-handler.js";
+import { CapabilityStore } from "../services/capability-store.js";
+import { ServerInfoPreloader } from "../services/server-info-preloader.js";
+import { ExecuteLuaTool } from "../tools/execute-lua-tool.js";
+import { ListServersTool } from "../tools/list-servers-tool.js";
+import { ListServerToolsTool } from "../tools/list-server-tools-tool.js";
+import { ToolDetailsTool } from "../tools/tool-details-tool.js";
+import { InspectToolResponseTool } from "../tools/inspect-tool-response-tool.js";
+import { SummaryStatsTool } from "../tools/summary-stats-tool.js";
+import { ToolRegistry } from "../tools/tool-registry.js";
+export function createContainer(config) {
+    const container = new Container();
+    container.bind(TYPES.ServerConfig).toConstantValue(config);
+    container.bind(TYPES.Logger).to(ConsoleLogger).inSingletonScope();
+    container
+        .bind(TYPES.LuaRuntime)
+        .to(WasmoonRuntime)
+        .inSingletonScope();
+    container
+        .bind(TYPES.MCPClientManager)
+        .to(MCPClientManager)
+        .inSingletonScope();
+    container
+        .bind(TYPES.MCPFormatterService)
+        .to(MCPFormatterService)
+        .inSingletonScope();
+    container
+        .bind(TYPES.ToolDiscoveryService)
+        .to(ToolDiscoveryService)
+        .inSingletonScope();
+    container
+        .bind(TYPES.ResourceAggregationService)
+        .to(ResourceAggregationService)
+        .inSingletonScope();
+    container
+        .bind(TYPES.PromptAggregationService)
+        .to(PromptAggregationService)
+        .inSingletonScope();
+    container.bind(TYPES.Tool).to(ExecuteLuaTool);
+    container.bind(TYPES.Tool).to(ListServersTool);
+    container.bind(TYPES.Tool).to(ListServerToolsTool);
+    container.bind(TYPES.Tool).to(ToolDetailsTool);
+    container.bind(TYPES.Tool).to(InspectToolResponseTool);
+    container.bind(TYPES.Tool).to(SummaryStatsTool);
+    container
+        .bind(TYPES.ToolRegistry)
+        .toDynamicValue(() => {
+        const registry = new ToolRegistry();
+        const tools = container.getAll(TYPES.Tool);
+        for (const tool of tools) {
+            registry.register(tool);
+        }
+        return registry;
+    })
+        .inSingletonScope();
+    container
+        .bind(TYPES.MCPGatewayServer)
+        .to(MCPGatewayServer)
+        .inSingletonScope();
+    container
+        .bind(TYPES.ShutdownHandler)
+        .to(ShutdownHandler)
+        .inSingletonScope();
+    container
+        .bind(TYPES.CapabilityStore)
+        .to(CapabilityStore)
+        .inSingletonScope();
+    container
+        .bind(TYPES.ServerInfoPreloader)
+        .to(ServerInfoPreloader)
+        .inSingletonScope();
+    return container;
+}
+//# sourceMappingURL=inversify.config.js.map

package/dist/container/inversify.config.js.map

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

package/dist/controllers/mcp-session-controller.d.ts

@@ -0,0 +1,21 @@
+import type { IMCPClientManager, ITransportManager, ILogger, ServerConfig, IMCPSessionController } from "../types/interfaces.js";
+import type { IToolRegistry } from "../tools/tool-registry.js";
+import type { ResourceAggregationService } from "../mcp/resource-aggregation-service.js";
+import type { PromptAggregationService } from "../mcp/prompt-aggregation-service.js";
+export declare class MCPSessionController implements IMCPSessionController {
+    private clientPool;
+    private transportManager;
+    private toolRegistry;
+    private resourceAggregation;
+    private promptAggregation;
+    private config;
+    private logger;
+    private connectingTransports;
+    private connectedTransports;
+    private gatewayServers;
+    constructor(clientPool: IMCPClientManager, transportManager: ITransportManager, toolRegistry: IToolRegistry, resourceAggregation: ResourceAggregationService, promptAggregation: PromptAggregationService, config: ServerConfig, logger: ILogger);
+    handleRequest(req: Request): Promise<Response>;
+    private initializeClientsForSession;
+    private connectGatewayServer;
+}
+//# sourceMappingURL=mcp-session-controller.d.ts.map

package/dist/controllers/mcp-session-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-session-controller.d.ts","sourceRoot":"","sources":["../../src/controllers/mcp-session-controller.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACzF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAiBrF,qBACa,oBAAqB,YAAW,qBAAqB;IAc7B,OAAO,CAAC,UAAU;IAEnD,OAAO,CAAC,gBAAgB;IACK,OAAO,CAAC,YAAY;IAEjD,OAAO,CAAC,mBAAmB;IAE3B,OAAO,CAAC,iBAAiB;IACI,OAAO,CAAC,MAAM;IACpB,OAAO,CAAC,MAAM;IArBvC,OAAO,CAAC,oBAAoB,CAC0B;IAEtD,OAAO,CAAC,mBAAmB,CAC+B;IAE1D,OAAO,CAAC,cAAc,CAGlB;IAEJ,YAC2C,UAAU,EAAE,iBAAiB,EAE9D,gBAAgB,EAAE,iBAAiB,EACN,YAAY,EAAE,aAAa,EAExD,mBAAmB,EAAE,0BAA0B,EAE/C,iBAAiB,EAAE,wBAAwB,EACd,MAAM,EAAE,YAAY,EAC1B,MAAM,EAAE,OAAO,EAC5C;IAaE,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA+CnD;YASa,2BAA2B;YAoC3B,oBAAoB;CAuBnC"}

package/dist/controllers/mcp-session-controller.js

@@ -0,0 +1,100 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable } from "inversify";
+import { $inject } from "../container/decorators.js";
+import { TYPES } from "../types/index.js";
+import { MCPGatewayServer } from "../mcp/gateway-server.js";
+let MCPSessionController = class MCPSessionController {
+    clientPool;
+    transportManager;
+    toolRegistry;
+    resourceAggregation;
+    promptAggregation;
+    config;
+    logger;
+    connectingTransports = new Set();
+    connectedTransports = new WeakSet();
+    gatewayServers = new WeakMap();
+    constructor(clientPool, transportManager, toolRegistry, resourceAggregation, promptAggregation, config, logger) {
+        this.clientPool = clientPool;
+        this.transportManager = transportManager;
+        this.toolRegistry = toolRegistry;
+        this.resourceAggregation = resourceAggregation;
+        this.promptAggregation = promptAggregation;
+        this.config = config;
+        this.logger = logger;
+    }
+    async handleRequest(req) {
+        try {
+            const sessionId = req.headers.get("mcp-session-id") ?? undefined;
+            const transport = this.transportManager.getOrCreateForRequest(sessionId);
+            const clientSession = sessionId || "default";
+            await this.initializeClientsForSession(clientSession);
+            if (!this.connectedTransports.has(transport)) {
+                if (!this.connectingTransports.has(transport)) {
+                    this.connectingTransports.add(transport);
+                    try {
+                        await this.connectGatewayServer(transport, clientSession);
+                        this.connectedTransports.add(transport);
+                    }
+                    finally {
+                        this.connectingTransports.delete(transport);
+                    }
+                }
+                else {
+                    while (this.connectingTransports.has(transport)) {
+                        await new Promise((resolve) => setTimeout(resolve, 10));
+                    }
+                }
+            }
+            return await transport.handleRequest(req);
+        }
+        catch (error) {
+            this.logger.error(`Error handling MCP request: ${error}`, error);
+            throw error;
+        }
+    }
+    async initializeClientsForSession(sessionId) {
+        for (const [name, clientConfig] of Object.entries(this.config.mcpClients)) {
+            if (clientConfig.type === "http") {
+                await this.clientPool.addHttpClient(name, clientConfig.url, sessionId, clientConfig.headers, clientConfig.allowedTools);
+            }
+            else if (clientConfig.type === "stdio") {
+                await this.clientPool.addStdioClient(name, clientConfig.command, sessionId, clientConfig.args, clientConfig.env, clientConfig.allowedTools);
+            }
+            else {
+                const unknownConfig = clientConfig;
+                this.logger.error(`Unsupported client type '${unknownConfig.type}' for '${name}'`);
+            }
+        }
+    }
+    async connectGatewayServer(transport, sessionId) {
+        this.logger.info(`Creating new gateway server instance for session ${sessionId}`);
+        const gatewayServer = new MCPGatewayServer(this.toolRegistry, this.clientPool, this.logger, this.resourceAggregation, this.promptAggregation);
+        this.gatewayServers.set(transport, gatewayServer);
+        await gatewayServer.getServer().connect(transport);
+    }
+};
+MCPSessionController = __decorate([
+    injectable(),
+    __param(0, $inject(TYPES.MCPClientManager)),
+    __param(1, $inject(TYPES.TransportManager)),
+    __param(2, $inject(TYPES.ToolRegistry)),
+    __param(3, $inject(TYPES.ResourceAggregationService)),
+    __param(4, $inject(TYPES.PromptAggregationService)),
+    __param(5, $inject(TYPES.ServerConfig)),
+    __param(6, $inject(TYPES.Logger)),
+    __metadata("design:paramtypes", [Object, Object, Object, Function, Function, Object, Object])
+], MCPSessionController);
+export { MCPSessionController };
+//# sourceMappingURL=mcp-session-controller.js.map

package/dist/controllers/mcp-session-controller.js.map

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

package/dist/e2e/fixtures/toy-servers/calculator-server.d.ts

@@ -0,0 +1,5 @@
+export declare function startHttpCalculatorServer(port: number): Promise<{
+    close: () => Promise<void>;
+}>;
+export declare function startStdioCalculatorServer(): Promise<never>;
+//# sourceMappingURL=calculator-server.d.ts.map

package/dist/e2e/fixtures/toy-servers/calculator-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator-server.d.ts","sourceRoot":"","sources":["../../../../src/e2e/fixtures/toy-servers/calculator-server.ts"],"names":[],"mappings":"AA8HA,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACrE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC,CA+ED;AAMD,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,KAAK,CAAC,CAUjE"}