@karashiiro/my-cool-proxy 1.2.0 → 1.2.2

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/dist/e2e/fixtures/toy-servers/calculator-server.js

@@ -6,6 +6,9 @@ import { serve } from "@hono/node-server";
 import { Hono } from "hono";
 import * as z from "zod";
 import { randomUUID } from "node:crypto";
+/**
+ * Creates a calculator MCP server with basic math tools
+ */
 function createCalculatorServer() {
     const server = new McpServer({
         name: "calculator",
@@ -15,6 +18,7 @@ function createCalculatorServer() {
             tools: {},
         },
     });
+    // Add tool
     server.registerTool("add", {
         description: "Add two numbers",
         inputSchema: z.object({
@@ -32,6 +36,7 @@ function createCalculatorServer() {
             ],
         };
     });
+    // Multiply tool
     server.registerTool("multiply", {
         description: "Multiply two numbers",
         inputSchema: z.object({
@@ -49,6 +54,7 @@ function createCalculatorServer() {
             ],
         };
     });
+    // Subtract tool
     server.registerTool("subtract", {
         description: "Subtract two numbers",
         inputSchema: z.object({
@@ -66,6 +72,7 @@ function createCalculatorServer() {
             ],
         };
     });
+    // Divide tool
     server.registerTool("divide", {
         description: "Divide two numbers",
         inputSchema: z.object({
@@ -88,12 +95,18 @@ function createCalculatorServer() {
     });
     return server;
 }
+/**
+ * Starts the calculator server in HTTP mode on the specified port
+ */
 export async function startHttpCalculatorServer(port) {
+    // Track transports and servers per session
     const transports = new Map();
     const servers = new Map();
+    // Create HTTP server with Hono
     const app = new Hono();
     app.all("/mcp", async (c) => {
         const sessionId = c.req.header("mcp-session-id");
+        // Parse body to check if it's an initialize request
         const rawRequest = c.req.raw;
         const bodyText = await rawRequest.text();
         let body = null;
@@ -103,11 +116,13 @@ export async function startHttpCalculatorServer(port) {
         catch {
             // Invalid JSON
         }
+        // Helper to recreate request (since we consumed the body)
         const recreateRequest = () => new Request(rawRequest.url, {
             method: rawRequest.method,
             headers: rawRequest.headers,
             body: bodyText || undefined,
         });
+        // New session: no session ID and initialize request
         if (!sessionId && body && isInitializeRequest(body)) {
             const newSessionId = randomUUID();
             const transport = new WebStandardStreamableHTTPServerTransport({
@@ -119,6 +134,7 @@ export async function startHttpCalculatorServer(port) {
             servers.set(newSessionId, server);
             return transport.handleRequest(recreateRequest());
         }
+        // Existing session
         if (sessionId) {
             const transport = transports.get(sessionId);
             if (!transport) {
@@ -126,6 +142,7 @@ export async function startHttpCalculatorServer(port) {
             }
             return transport.handleRequest(recreateRequest());
         }
+        // Invalid request (no session ID, not an initialize request)
         return c.text("Bad request - missing session ID", 400);
     });
     const httpServer = serve({
@@ -135,6 +152,7 @@ export async function startHttpCalculatorServer(port) {
     });
     return {
         close: async () => {
+            // Close all servers and transports
             for (const server of servers.values()) {
                 await server.close();
             }
@@ -146,13 +164,22 @@ export async function startHttpCalculatorServer(port) {
         },
     };
 }
+/**
+ * Starts the calculator server in stdio mode (for use as child process)
+ * This function does not return - it runs the server on stdin/stdout
+ */
 export async function startStdioCalculatorServer() {
     const server = createCalculatorServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
+    // Keep process alive indefinitely
+    // The transport handles stdin/stdout, we just need to prevent exit
     return new Promise(() => {
+        // Never resolves - keeps the process running forever
     });
 }
+// If this file is run directly, start in stdio mode
+// Check if this is the main module
 if (process.argv[1]) {
     const { fileURLToPath } = await import("node:url");
     const currentFile = fileURLToPath(import.meta.url);
@@ -161,4 +188,3 @@ if (process.argv[1]) {
         startStdioCalculatorServer().catch(console.error);
     }
 }
-//# sourceMappingURL=calculator-server.js.map

package/dist/e2e/fixtures/toy-servers/data-server.js

@@ -6,6 +6,7 @@ import { serve } from "@hono/node-server";
 import { Hono } from "hono";
 import * as z from "zod";
 import { randomUUID } from "node:crypto";
+// Sample data for resources
 const testData = {
     users: [
         { id: 1, name: "Alice", role: "admin" },
@@ -31,6 +32,9 @@ const fileContents = {
     "test-data.json": JSON.stringify(testData, null, 2),
     "config.yaml": configYaml,
 };
+/**
+ * Creates a data server MCP server with resources, tools, and prompts
+ */
 function createDataServer() {
     const server = new McpServer({
         name: "data-server",
@@ -42,6 +46,7 @@ function createDataServer() {
             resources: {},
         },
     });
+    // Register tools
     server.registerTool("list-files", {
         description: "List all available files",
         inputSchema: z.object({}),
@@ -77,6 +82,7 @@ function createDataServer() {
         }
         throw new Error(`File not found: ${filename}`);
     });
+    // Register prompts
     server.registerPrompt("data-analysis", {
         description: "Analyze the sample data",
         argsSchema: {
@@ -96,6 +102,7 @@ function createDataServer() {
             ],
         };
     });
+    // Register resources
     const testDataCallback = async (uri) => {
         return {
             contents: [
@@ -122,12 +129,18 @@ function createDataServer() {
     server.resource("config", "file:///config.yaml", configCallback);
     return server;
 }
+/**
+ * Starts the data server in HTTP mode on the specified port
+ */
 export async function startHttpDataServer(port) {
+    // Track transports and servers per session
     const transports = new Map();
     const servers = new Map();
+    // Create HTTP server with Hono
     const app = new Hono();
     app.all("/mcp", async (c) => {
         const sessionId = c.req.header("mcp-session-id");
+        // Parse body to check if it's an initialize request
         const rawRequest = c.req.raw;
         const bodyText = await rawRequest.text();
         let body = null;
@@ -137,11 +150,13 @@ export async function startHttpDataServer(port) {
         catch {
             // Invalid JSON
         }
+        // Helper to recreate request (since we consumed the body)
         const recreateRequest = () => new Request(rawRequest.url, {
             method: rawRequest.method,
             headers: rawRequest.headers,
             body: bodyText || undefined,
         });
+        // New session: no session ID and initialize request
         if (!sessionId && body && isInitializeRequest(body)) {
             const newSessionId = randomUUID();
             const transport = new WebStandardStreamableHTTPServerTransport({
@@ -153,6 +168,7 @@ export async function startHttpDataServer(port) {
             servers.set(newSessionId, server);
             return transport.handleRequest(recreateRequest());
         }
+        // Existing session
         if (sessionId) {
             const transport = transports.get(sessionId);
             if (!transport) {
@@ -160,6 +176,7 @@ export async function startHttpDataServer(port) {
             }
             return transport.handleRequest(recreateRequest());
         }
+        // Invalid request (no session ID, not an initialize request)
         return c.text("Bad request - missing session ID", 400);
     });
     const httpServer = serve({
@@ -169,6 +186,7 @@ export async function startHttpDataServer(port) {
     });
     return {
         close: async () => {
+            // Close all servers and transports
             for (const server of servers.values()) {
                 await server.close();
             }
@@ -180,13 +198,22 @@ export async function startHttpDataServer(port) {
         },
     };
 }
+/**
+ * Starts the data server in stdio mode (for use as child process)
+ * This function does not return - it runs the server on stdin/stdout
+ */
 export async function startStdioDataServer() {
     const server = createDataServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
+    // Keep process alive indefinitely
+    // The transport handles stdin/stdout, we just need to prevent exit
     return new Promise(() => {
+        // Never resolves - keeps the process running forever
     });
 }
+// If this file is run directly, start in stdio mode
+// Check if this is the main module
 if (process.argv[1]) {
     const { fileURLToPath } = await import("node:url");
     const currentFile = fileURLToPath(import.meta.url);
@@ -195,4 +222,3 @@ if (process.argv[1]) {
         startStdioDataServer().catch(console.error);
     }
 }
-//# sourceMappingURL=data-server.js.map

package/dist/e2e/fixtures/toy-servers/elicitation-server.js

@@ -6,6 +6,11 @@ import { serve } from "@hono/node-server";
 import { Hono } from "hono";
 import * as z from "zod";
 import { randomUUID } from "node:crypto";
+/**
+ * Creates an MCP server that uses elicitation requests.
+ * This server's tools will trigger elicitation requests to the connected client,
+ * which allows testing the elicitation proxy functionality.
+ */
 function createElicitationServer() {
     const server = new McpServer({
         name: "elicitation-test-server",
@@ -15,6 +20,7 @@ function createElicitationServer() {
             tools: {},
         },
     });
+    // Tool that triggers a form elicitation request
     server.registerTool("ask_user_form", {
         description: "Ask the user for structured input via a form. This will send an elicitation request to the connected client.",
         inputSchema: z.object({
@@ -22,6 +28,7 @@ function createElicitationServer() {
         }),
     }, async (args) => {
         const { prompt } = args;
+        // Send form elicitation request to the connected client
         const result = await server.server.elicitInput({
             message: prompt,
             requestedSchema: {
@@ -68,6 +75,7 @@ function createElicitationServer() {
             };
         }
     });
+    // Tool that asks for multiple fields
     server.registerTool("ask_user_details", {
         description: "Ask the user for multiple details via a form",
         inputSchema: z.object({
@@ -123,12 +131,18 @@ function createElicitationServer() {
     });
     return server;
 }
+/**
+ * Starts the elicitation server in HTTP mode on the specified port
+ */
 export async function startHttpElicitationServer(port) {
+    // Track transports and servers per session
     const transports = new Map();
     const servers = new Map();
+    // Create HTTP server with Hono
     const app = new Hono();
     app.all("/mcp", async (c) => {
         const sessionId = c.req.header("mcp-session-id");
+        // Parse body to check if it's an initialize request
         const rawRequest = c.req.raw;
         const bodyText = await rawRequest.text();
         let body = null;
@@ -138,11 +152,13 @@ export async function startHttpElicitationServer(port) {
         catch {
             // Invalid JSON
         }
+        // Helper to recreate request (since we consumed the body)
         const recreateRequest = () => new Request(rawRequest.url, {
             method: rawRequest.method,
             headers: rawRequest.headers,
             body: bodyText || undefined,
         });
+        // New session: no session ID and initialize request
         if (!sessionId && body && isInitializeRequest(body)) {
             const newSessionId = randomUUID();
             const transport = new WebStandardStreamableHTTPServerTransport({
@@ -154,6 +170,7 @@ export async function startHttpElicitationServer(port) {
             servers.set(newSessionId, server);
             return transport.handleRequest(recreateRequest());
         }
+        // Existing session
         if (sessionId) {
             const transport = transports.get(sessionId);
             if (!transport) {
@@ -161,6 +178,7 @@ export async function startHttpElicitationServer(port) {
             }
             return transport.handleRequest(recreateRequest());
         }
+        // Invalid request (no session ID, not an initialize request)
         return c.text("Bad request - missing session ID", 400);
     });
     const httpServer = serve({
@@ -170,6 +188,7 @@ export async function startHttpElicitationServer(port) {
     });
     return {
         close: async () => {
+            // Close all servers and transports
             for (const server of servers.values()) {
                 await server.close();
             }
@@ -181,13 +200,20 @@ export async function startHttpElicitationServer(port) {
         },
     };
 }
+/**
+ * Starts the elicitation server in stdio mode (for use as child process)
+ * This function does not return - it runs the server on stdin/stdout
+ */
 export async function startStdioElicitationServer() {
     const server = createElicitationServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
+    // Keep process alive indefinitely
     return new Promise(() => {
+        // Never resolves - keeps the process running forever
     });
 }
+// If this file is run directly, start in stdio mode
 if (process.argv[1]) {
     const { fileURLToPath } = await import("node:url");
     const currentFile = fileURLToPath(import.meta.url);
@@ -196,4 +222,3 @@ if (process.argv[1]) {
         startStdioElicitationServer().catch(console.error);
     }
 }
-//# sourceMappingURL=elicitation-server.js.map

package/dist/e2e/fixtures/toy-servers/index.js

@@ -3,4 +3,3 @@ export { startHttpDataServer, startStdioDataServer } from "./data-server.js";
 export { startHttpSamplingServer, startStdioSamplingServer, } from "./sampling-server.js";
 export { startHttpElicitationServer, startStdioElicitationServer, } from "./elicitation-server.js";
 export { startStdioStderrServer } from "./stderr-server.js";
-//# sourceMappingURL=index.js.map

package/dist/e2e/fixtures/toy-servers/sampling-server.js

@@ -6,6 +6,11 @@ import { serve } from "@hono/node-server";
 import { Hono } from "hono";
 import * as z from "zod";
 import { randomUUID } from "node:crypto";
+/**
+ * Creates an MCP server that uses sampling requests.
+ * This server's tools will trigger sampling requests to the connected client,
+ * which allows testing the sampling proxy functionality.
+ */
 function createSamplingServer() {
     const server = new McpServer({
         name: "sampling-test-server",
@@ -15,6 +20,7 @@ function createSamplingServer() {
             tools: {},
         },
     });
+    // Tool that triggers a sampling request to ask the LLM a question
     server.registerTool("ask_llm", {
         description: "Ask the LLM a question via sampling. This will send a sampling request to the connected client.",
         inputSchema: z.object({
@@ -22,6 +28,8 @@ function createSamplingServer() {
         }),
     }, async (args) => {
         const { question } = args;
+        // Send sampling request to the connected client (our proxy)
+        // The proxy will forward this to its downstream client
         const result = await server.server.createMessage({
             messages: [
                 {
@@ -34,6 +42,7 @@ function createSamplingServer() {
             ],
             maxTokens: 100,
         });
+        // Extract the text content from the response
         const responseText = result.content.type === "text"
             ? result.content.text
             : JSON.stringify(result.content);
@@ -46,6 +55,7 @@ function createSamplingServer() {
             ],
         };
     });
+    // Tool that asks a multi-turn question
     server.registerTool("multi_turn_llm", {
         description: "Ask the LLM with context from previous messages. Tests multi-message sampling.",
         inputSchema: z.object({
@@ -94,12 +104,18 @@ function createSamplingServer() {
     });
     return server;
 }
+/**
+ * Starts the sampling server in HTTP mode on the specified port
+ */
 export async function startHttpSamplingServer(port) {
+    // Track transports and servers per session
     const transports = new Map();
     const servers = new Map();
+    // Create HTTP server with Hono
     const app = new Hono();
     app.all("/mcp", async (c) => {
         const sessionId = c.req.header("mcp-session-id");
+        // Parse body to check if it's an initialize request
         const rawRequest = c.req.raw;
         const bodyText = await rawRequest.text();
         let body = null;
@@ -109,11 +125,13 @@ export async function startHttpSamplingServer(port) {
         catch {
             // Invalid JSON
         }
+        // Helper to recreate request (since we consumed the body)
         const recreateRequest = () => new Request(rawRequest.url, {
             method: rawRequest.method,
             headers: rawRequest.headers,
             body: bodyText || undefined,
         });
+        // New session: no session ID and initialize request
         if (!sessionId && body && isInitializeRequest(body)) {
             const newSessionId = randomUUID();
             const transport = new WebStandardStreamableHTTPServerTransport({
@@ -125,6 +143,7 @@ export async function startHttpSamplingServer(port) {
             servers.set(newSessionId, server);
             return transport.handleRequest(recreateRequest());
         }
+        // Existing session
         if (sessionId) {
             const transport = transports.get(sessionId);
             if (!transport) {
@@ -132,6 +151,7 @@ export async function startHttpSamplingServer(port) {
             }
             return transport.handleRequest(recreateRequest());
         }
+        // Invalid request (no session ID, not an initialize request)
         return c.text("Bad request - missing session ID", 400);
     });
     const httpServer = serve({
@@ -141,6 +161,7 @@ export async function startHttpSamplingServer(port) {
     });
     return {
         close: async () => {
+            // Close all servers and transports
             for (const server of servers.values()) {
                 await server.close();
             }
@@ -152,13 +173,20 @@ export async function startHttpSamplingServer(port) {
         },
     };
 }
+/**
+ * Starts the sampling server in stdio mode (for use as child process)
+ * This function does not return - it runs the server on stdin/stdout
+ */
 export async function startStdioSamplingServer() {
     const server = createSamplingServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
+    // Keep process alive indefinitely
     return new Promise(() => {
+        // Never resolves - keeps the process running forever
     });
 }
+// If this file is run directly, start in stdio mode
 if (process.argv[1]) {
     const { fileURLToPath } = await import("node:url");
     const currentFile = fileURLToPath(import.meta.url);
@@ -167,4 +195,3 @@ if (process.argv[1]) {
         startStdioSamplingServer().catch(console.error);
     }
 }
-//# sourceMappingURL=sampling-server.js.map

package/dist/e2e/fixtures/toy-servers/stderr-server.js

@@ -1,6 +1,11 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import * as z from "zod";
+/**
+ * Creates an MCP server that writes to stderr for testing stderr logging.
+ * This server intentionally outputs messages to stderr on startup and
+ * when its tool is called.
+ */
 function createStderrServer() {
     const server = new McpServer({
         name: "stderr-test-server",
@@ -10,6 +15,7 @@ function createStderrServer() {
             tools: {},
         },
     });
+    // Tool that writes to stderr
     server.registerTool("write_to_stderr", {
         description: "Write a message to stderr for testing",
         inputSchema: z.object({
@@ -17,6 +23,7 @@ function createStderrServer() {
         }),
     }, async (args) => {
         const { message } = args;
+        // Write to stderr
         process.stderr.write(`[stderr-test] Tool called: ${message}\n`);
         return {
             content: [
@@ -27,6 +34,7 @@ function createStderrServer() {
             ],
         };
     });
+    // Simple echo tool for verifying server is working
     server.registerTool("echo", {
         description: "Echo back the input message",
         inputSchema: z.object({
@@ -45,21 +53,31 @@ function createStderrServer() {
     });
     return server;
 }
+/**
+ * Starts the stderr test server in stdio mode.
+ * Writes to stderr on startup to verify logging is captured.
+ */
 export async function startStdioStderrServer() {
+    // Write startup message to stderr
     process.stderr.write("[stderr-test] Server starting up...\n");
     const server = createStderrServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
+    // Write ready message to stderr
     process.stderr.write("[stderr-test] Server ready and accepting connections\n");
+    // Handle shutdown signals
     const handleShutdown = () => {
         process.stderr.write("[stderr-test] Server shutting down (received signal)\n");
         process.exit(0);
     };
     process.on("SIGINT", handleShutdown);
     process.on("SIGTERM", handleShutdown);
+    // Keep process alive indefinitely
     return new Promise(() => {
+        // Never resolves - keeps the process running forever
     });
 }
+// If this file is run directly, start in stdio mode
 if (process.argv[1]) {
     const { fileURLToPath } = await import("node:url");
     const currentFile = fileURLToPath(import.meta.url);
@@ -68,4 +86,3 @@ if (process.argv[1]) {
         startStdioStderrServer().catch(console.error);
     }
 }
-//# sourceMappingURL=stderr-server.js.map

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import "reflect-metadata";
-//# sourceMappingURL=index.d.ts.map
+
+export {  }