@agimon-ai/mcp-proxy 0.5.0 → 0.5.2

package/dist/index.d.cts

@@ -50,7 +50,7 @@ type TransportMode = (typeof TRANSPORT_MODE)[keyof typeof TRANSPORT_MODE];
  */
 interface TransportConfig {
   mode: TransportMode;
-  port?: number;
+  port: number;
   host?: string;
 }
 /**
@@ -260,6 +260,11 @@ interface PromptConfig {
  */
 interface RemoteMcpConfiguration {
   id?: string;
+  proxy?: {
+    type?: string;
+    port?: number;
+    host?: string;
+  };
   mcpServers: Record<string, McpServerConfig>;
   skills?: SkillsConfig;
 }
@@ -515,6 +520,62 @@ declare class ConfigFetcherService {
   isCacheValid(): boolean;
 }
 //#endregion
+//#region src/services/McpClientManagerService.d.ts
+/**
+ * Service for managing MCP client connections to remote servers
+ */
+declare class McpClientManagerService {
+  private clients;
+  private serverConfigs;
+  private connectionPromises;
+  private logger;
+  constructor(logger?: LoggerLike);
+  /**
+   * Kill all stdio MCP server child processes.
+   * Sends SIGTERM first, then SIGKILL after 1s if the process hasn't exited.
+   * Must be called by the owner (e.g. transport/command layer) during shutdown.
+   * Awaiting the returned promise ensures force-kill timers complete before process.exit().
+   */
+  cleanupChildProcesses(): Promise<void>;
+  /**
+   * Connect to an MCP server based on its configuration with timeout
+   * Uses the timeout from server config, falling back to default (30s)
+   */
+  connectToServer(serverName: string, config: McpServerConfig): Promise<void>;
+  registerServerConfigs(configs: Record<string, McpServerConfig>): void;
+  getKnownServerNames(): string[];
+  getServerRequestTimeout(serverName: string): number | undefined;
+  ensureConnected(serverName: string): Promise<McpClientConnection>;
+  private createConnection;
+  /**
+   * Perform the actual connection to MCP server
+   */
+  private performConnection;
+  private connectStdioClient;
+  private connectHttpClient;
+  private connectSseClient;
+  /**
+   * Get a connected client by server name
+   */
+  getClient(serverName: string): McpClientConnection | undefined;
+  /**
+   * Get all connected clients
+   */
+  getAllClients(): McpClientConnection[];
+  /**
+   * Disconnect from a specific server
+   */
+  disconnectServer(serverName: string): Promise<void>;
+  /**
+   * Disconnect from all servers
+   */
+  disconnectAll(): Promise<void>;
+  /**
+   * Check if a server is connected
+   */
+  isConnected(serverName: string): boolean;
+}
+//#endregion
 //#region src/services/SkillService.d.ts
 /**
  * Service for loading and managing skills from configured skill directories.
@@ -643,60 +704,6 @@ declare class SkillService {
   private loadSkillFile;
 }
 //#endregion
-//#region src/services/McpClientManagerService.d.ts
-/**
- * Service for managing MCP client connections to remote servers
- */
-declare class McpClientManagerService {
-  private clients;
-  private serverConfigs;
-  private connectionPromises;
-  private logger;
-  constructor(logger?: LoggerLike);
-  /**
-   * Synchronously kill all stdio MCP server child processes.
-   * Must be called by the owner (e.g. transport/command layer) during shutdown.
-   */
-  cleanupChildProcesses(): void;
-  /**
-   * Connect to an MCP server based on its configuration with timeout
-   * Uses the timeout from server config, falling back to default (30s)
-   */
-  connectToServer(serverName: string, config: McpServerConfig): Promise<void>;
-  registerServerConfigs(configs: Record<string, McpServerConfig>): void;
-  getKnownServerNames(): string[];
-  getServerRequestTimeout(serverName: string): number | undefined;
-  ensureConnected(serverName: string): Promise<McpClientConnection>;
-  private createConnection;
-  /**
-   * Perform the actual connection to MCP server
-   */
-  private performConnection;
-  private connectStdioClient;
-  private connectHttpClient;
-  private connectSseClient;
-  /**
-   * Get a connected client by server name
-   */
-  getClient(serverName: string): McpClientConnection | undefined;
-  /**
-   * Get all connected clients
-   */
-  getAllClients(): McpClientConnection[];
-  /**
-   * Disconnect from a specific server
-   */
-  disconnectServer(serverName: string): Promise<void>;
-  /**
-   * Disconnect from all servers
-   */
-  disconnectAll(): Promise<void>;
-  /**
-   * Check if a server is connected
-   */
-  isConnected(serverName: string): boolean;
-}
-//#endregion
 //#region src/services/DefinitionsCacheService.d.ts
 interface DefinitionsCacheServiceOptions {
   cacheData?: DefinitionsCacheFile;
@@ -1115,21 +1122,29 @@ declare class UseToolTool implements Tool<UseToolToolInput> {
 /**
  * HTTP transport handler using Streamable HTTP (protocol version 2025-03-26)
  * Provides stateful session management with resumability support
+ *
+ * Uses a hybrid server architecture:
+ * - Raw Node.js createServer for /mcp routes (MCP SDK needs native req/res)
+ * - Hono for REST routes (/health, /admin/shutdown)
  */
 declare class HttpTransportHandler implements HttpTransportHandler$1 {
   private serverFactory;
-  private app;
+  private honoApp;
   private server;
   private sessionManager;
   private config;
   private adminOptions?;
   private adminRateLimiter;
   private logger;
-  constructor(serverFactory: (() => Server | Promise<Server>), config: TransportConfig, adminOptions?: HttpTransportAdminOptions, logger?: LoggerLike);
-  private setupMiddleware;
-  private setupRoutes;
+  constructor(serverFactory: () => Server | Promise<Server>, config: TransportConfig, adminOptions?: HttpTransportAdminOptions, logger?: LoggerLike);
+  private setupHonoRoutes;
   private isAuthorizedShutdownRequest;
   private handleAdminShutdownRequest;
+  /**
+   * Handle MCP protocol requests (POST/GET/DELETE /mcp)
+   * Uses raw Node.js req/res as required by MCP SDK
+   */
+  private handleMcpRequest;
   private handlePostRequest;
   private handleGetRequest;
   private handleDeleteRequest;
@@ -1147,14 +1162,13 @@ declare class HttpTransportHandler implements HttpTransportHandler$1 {
  */
 declare class SseTransportHandler implements HttpTransportHandler$1 {
   private serverFactory;
-  private app;
+  private honoApp;
   private server;
   private sessionManager;
   private config;
   private logger;
   constructor(serverFactory: Server | (() => Server), config: TransportConfig, logger?: LoggerLike);
-  private setupMiddleware;
-  private setupRoutes;
+  private setupHonoRoutes;
   private handleSseConnection;
   private handlePostMessage;
   start(): Promise<void>;

package/dist/index.d.mts

@@ -51,7 +51,7 @@ type TransportMode = (typeof TRANSPORT_MODE)[keyof typeof TRANSPORT_MODE];
  */
 interface TransportConfig {
   mode: TransportMode;
-  port?: number;
+  port: number;
   host?: string;
 }
 /**
@@ -261,6 +261,11 @@ interface PromptConfig {
  */
 interface RemoteMcpConfiguration {
   id?: string;
+  proxy?: {
+    type?: string;
+    port?: number;
+    host?: string;
+  };
   mcpServers: Record<string, McpServerConfig>;
   skills?: SkillsConfig;
 }
@@ -516,6 +521,62 @@ declare class ConfigFetcherService {
   isCacheValid(): boolean;
 }
 //#endregion
+//#region src/services/McpClientManagerService.d.ts
+/**
+ * Service for managing MCP client connections to remote servers
+ */
+declare class McpClientManagerService {
+  private clients;
+  private serverConfigs;
+  private connectionPromises;
+  private logger;
+  constructor(logger?: LoggerLike);
+  /**
+   * Kill all stdio MCP server child processes.
+   * Sends SIGTERM first, then SIGKILL after 1s if the process hasn't exited.
+   * Must be called by the owner (e.g. transport/command layer) during shutdown.
+   * Awaiting the returned promise ensures force-kill timers complete before process.exit().
+   */
+  cleanupChildProcesses(): Promise<void>;
+  /**
+   * Connect to an MCP server based on its configuration with timeout
+   * Uses the timeout from server config, falling back to default (30s)
+   */
+  connectToServer(serverName: string, config: McpServerConfig): Promise<void>;
+  registerServerConfigs(configs: Record<string, McpServerConfig>): void;
+  getKnownServerNames(): string[];
+  getServerRequestTimeout(serverName: string): number | undefined;
+  ensureConnected(serverName: string): Promise<McpClientConnection>;
+  private createConnection;
+  /**
+   * Perform the actual connection to MCP server
+   */
+  private performConnection;
+  private connectStdioClient;
+  private connectHttpClient;
+  private connectSseClient;
+  /**
+   * Get a connected client by server name
+   */
+  getClient(serverName: string): McpClientConnection | undefined;
+  /**
+   * Get all connected clients
+   */
+  getAllClients(): McpClientConnection[];
+  /**
+   * Disconnect from a specific server
+   */
+  disconnectServer(serverName: string): Promise<void>;
+  /**
+   * Disconnect from all servers
+   */
+  disconnectAll(): Promise<void>;
+  /**
+   * Check if a server is connected
+   */
+  isConnected(serverName: string): boolean;
+}
+//#endregion
 //#region src/services/SkillService.d.ts
 /**
  * Service for loading and managing skills from configured skill directories.
@@ -644,60 +705,6 @@ declare class SkillService {
   private loadSkillFile;
 }
 //#endregion
-//#region src/services/McpClientManagerService.d.ts
-/**
- * Service for managing MCP client connections to remote servers
- */
-declare class McpClientManagerService {
-  private clients;
-  private serverConfigs;
-  private connectionPromises;
-  private logger;
-  constructor(logger?: LoggerLike);
-  /**
-   * Synchronously kill all stdio MCP server child processes.
-   * Must be called by the owner (e.g. transport/command layer) during shutdown.
-   */
-  cleanupChildProcesses(): void;
-  /**
-   * Connect to an MCP server based on its configuration with timeout
-   * Uses the timeout from server config, falling back to default (30s)
-   */
-  connectToServer(serverName: string, config: McpServerConfig): Promise<void>;
-  registerServerConfigs(configs: Record<string, McpServerConfig>): void;
-  getKnownServerNames(): string[];
-  getServerRequestTimeout(serverName: string): number | undefined;
-  ensureConnected(serverName: string): Promise<McpClientConnection>;
-  private createConnection;
-  /**
-   * Perform the actual connection to MCP server
-   */
-  private performConnection;
-  private connectStdioClient;
-  private connectHttpClient;
-  private connectSseClient;
-  /**
-   * Get a connected client by server name
-   */
-  getClient(serverName: string): McpClientConnection | undefined;
-  /**
-   * Get all connected clients
-   */
-  getAllClients(): McpClientConnection[];
-  /**
-   * Disconnect from a specific server
-   */
-  disconnectServer(serverName: string): Promise<void>;
-  /**
-   * Disconnect from all servers
-   */
-  disconnectAll(): Promise<void>;
-  /**
-   * Check if a server is connected
-   */
-  isConnected(serverName: string): boolean;
-}
-//#endregion
 //#region src/services/DefinitionsCacheService.d.ts
 interface DefinitionsCacheServiceOptions {
   cacheData?: DefinitionsCacheFile;
@@ -1116,21 +1123,29 @@ declare class UseToolTool implements Tool<UseToolToolInput> {
 /**
  * HTTP transport handler using Streamable HTTP (protocol version 2025-03-26)
  * Provides stateful session management with resumability support
+ *
+ * Uses a hybrid server architecture:
+ * - Raw Node.js createServer for /mcp routes (MCP SDK needs native req/res)
+ * - Hono for REST routes (/health, /admin/shutdown)
  */
 declare class HttpTransportHandler implements HttpTransportHandler$1 {
   private serverFactory;
-  private app;
+  private honoApp;
   private server;
   private sessionManager;
   private config;
   private adminOptions?;
   private adminRateLimiter;
   private logger;
-  constructor(serverFactory: (() => Server | Promise<Server>), config: TransportConfig, adminOptions?: HttpTransportAdminOptions, logger?: LoggerLike);
-  private setupMiddleware;
-  private setupRoutes;
+  constructor(serverFactory: () => Server | Promise<Server>, config: TransportConfig, adminOptions?: HttpTransportAdminOptions, logger?: LoggerLike);
+  private setupHonoRoutes;
   private isAuthorizedShutdownRequest;
   private handleAdminShutdownRequest;
+  /**
+   * Handle MCP protocol requests (POST/GET/DELETE /mcp)
+   * Uses raw Node.js req/res as required by MCP SDK
+   */
+  private handleMcpRequest;
   private handlePostRequest;
   private handleGetRequest;
   private handleDeleteRequest;
@@ -1148,14 +1163,13 @@ declare class HttpTransportHandler implements HttpTransportHandler$1 {
  */
 declare class SseTransportHandler implements HttpTransportHandler$1 {
   private serverFactory;
-  private app;
+  private honoApp;
   private server;
   private sessionManager;
   private config;
   private logger;
   constructor(serverFactory: Server | (() => Server), config: TransportConfig, logger?: LoggerLike);
-  private setupMiddleware;
-  private setupRoutes;
+  private setupHonoRoutes;
   private handleSseConnection;
   private handlePostMessage;
   start(): Promise<void>;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { C as SearchListToolsTool, D as findConfigFile, E as generateServerId, S as UseToolTool, T as DefinitionsCacheService, _ as StopServerService, a as createProxyContainer, b as createProxyLogger, c as createStdioHttpTransportHandler, f as StdioHttpTransportHandler, g as SkillService, h as HttpTransportHandler, i as createHttpTransportHandler, l as createStdioTransportHandler, m as SseTransportHandler, n as createServer, p as StdioTransportHandler, r as createSessionServer, s as createSseTransportHandler, t as TRANSPORT_MODE, u as initializeSharedServices, v as RuntimeStateService, w as DescribeToolsTool, x as ConfigFetcherService, y as McpClientManagerService } from "./src-DCIv5S_2.mjs";
+import { C as DefinitionsCacheService, E as ConfigFetcherService, S as createProxyLogger, T as findConfigFile, _ as DescribeToolsTool, a as createProxyContainer, b as RuntimeStateService, c as createStdioHttpTransportHandler, d as StdioHttpTransportHandler, f as StdioTransportHandler, g as SearchListToolsTool, h as UseToolTool, i as createHttpTransportHandler, l as createStdioTransportHandler, m as HttpTransportHandler, n as createServer, p as SseTransportHandler, r as createSessionServer, s as createSseTransportHandler, t as TRANSPORT_MODE, u as initializeSharedServices, v as SkillService, w as generateServerId, x as McpClientManagerService, y as StopServerService } from "./src-kgJ-iu3i.mjs";
 
 export { ConfigFetcherService, DefinitionsCacheService, DescribeToolsTool, HttpTransportHandler, McpClientManagerService, RuntimeStateService, SearchListToolsTool, SkillService, SseTransportHandler, StdioHttpTransportHandler, StdioTransportHandler, StopServerService, TRANSPORT_MODE, UseToolTool, createHttpTransportHandler, createProxyContainer, createProxyLogger, createServer, createSessionServer, createSseTransportHandler, createStdioHttpTransportHandler, createStdioTransportHandler, findConfigFile, generateServerId, initializeSharedServices };