mcp-test-kits 0.0.0

package/dist/index.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * Entry point for MCP Test Kits server (TypeScript)
+ */
+import { parseArgs } from "node:util";
+import { Config } from "./config.js";
+import { createServer } from "./server.js";
+import { runStdioServer, runHttpServer, runSseServer, } from "./transports/index.js";
+function printHelp() {
+    console.log(`
+MCP Test Kits - A comprehensive MCP testing server
+
+Usage:
+  mcp-test-kits [options]
+
+Options:
+  -t, --transport <type>  Transport type: stdio, http, sse (default: stdio)
+      --host <host>       Host to bind to (default: localhost)
+  -p, --port <port>       Port to listen on (default: 3000)
+  -l, --log-level <level> Log level: debug, info, warn, error (default: info)
+      --no-tools          Disable tools capability
+      --no-resources      Disable resources capability
+      --no-prompts        Disable prompts capability
+  -v, --version           Show version
+  -h, --help              Show this help
+
+Examples:
+  # Run with stdio (default)
+  mcp-test-kits
+
+  # Run with HTTP transport
+  mcp-test-kits --transport http --port 3000
+
+  # Run with only tools (no resources or prompts)
+  mcp-test-kits --no-resources --no-prompts
+`);
+}
+async function main() {
+    // Parse command line arguments
+    const { values } = parseArgs({
+        options: {
+            transport: { type: "string", short: "t", default: "stdio" },
+            host: { type: "string", default: "localhost" },
+            port: { type: "string", short: "p", default: "3000" },
+            "log-level": { type: "string", short: "l", default: "info" },
+            "no-tools": { type: "boolean", default: false },
+            "no-resources": { type: "boolean", default: false },
+            "no-prompts": { type: "boolean", default: false },
+            version: { type: "boolean", short: "v" },
+            help: { type: "boolean", short: "h" },
+        },
+        allowPositionals: true,
+    });
+    if (values.help) {
+        printHelp();
+        process.exit(0);
+    }
+    if (values.version) {
+        console.log("mcp-test-kits 1.0.0");
+        process.exit(0);
+    }
+    // Build config from CLI args
+    const transport = values.transport;
+    const host = values.host;
+    const port = parseInt(values.port, 10);
+    const config = new Config({
+        server: { name: "mcp-test-kits", version: "1.0.0" },
+        transport: { type: transport, network: { host, port } },
+        capabilities: {
+            tools: !values["no-tools"],
+            resources: !values["no-resources"],
+            prompts: !values["no-prompts"],
+        },
+    });
+    // Create server
+    const server = createServer(config);
+    // Run with appropriate transport
+    switch (transport) {
+        case "stdio":
+            await runStdioServer(server, config);
+            break;
+        case "http":
+            await runHttpServer(server, config);
+            break;
+        case "sse":
+            await runSseServer(server, config);
+            break;
+        default:
+            console.error(`Unknown transport type: ${transport}`);
+            process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/introspection.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Introspection utilities for extracting specifications from MCP Server
+ */
+import { McpServer, RegisteredTool, RegisteredResource, RegisteredResourceTemplate, RegisteredPrompt } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Extended McpServer with introspection capabilities.
+ * Provides access to registered tools, resources, and prompts for spec extraction.
+ */
+export declare class IntrospectableMcpServer extends McpServer {
+    /**
+     * Get all registered tools with their metadata
+     */
+    getRegisteredTools(): Record<string, RegisteredTool>;
+    /**
+     * Get all registered resources with their metadata
+     */
+    getRegisteredResources(): Record<string, RegisteredResource>;
+    /**
+     * Get all registered resource templates with their metadata
+     */
+    getRegisteredResourceTemplates(): Record<string, RegisteredResourceTemplate>;
+    /**
+     * Get all registered prompts with their metadata
+     */
+    getRegisteredPrompts(): Record<string, RegisteredPrompt>;
+}
+interface ToolSpec {
+    name: string;
+    description: string;
+}
+interface ResourceSpec {
+    name: string;
+    uri: string;
+    description?: string;
+    mimeType?: string;
+}
+interface PromptArgSpec {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+interface PromptSpec {
+    name: string;
+    description: string;
+    arguments?: PromptArgSpec[];
+}
+/**
+ * Extract tool specifications from an introspectable server
+ */
+export declare function extractToolsSpec(server: IntrospectableMcpServer): ToolSpec[];
+/**
+ * Extract resource specifications from an introspectable server
+ */
+export declare function extractResourcesSpec(server: IntrospectableMcpServer): ResourceSpec[];
+/**
+ * Extract prompt specifications from an introspectable server
+ */
+export declare function extractPromptsSpec(server: IntrospectableMcpServer): PromptSpec[];
+/**
+ * Extract full specification from an introspectable server
+ */
+export declare function extractSpec(server: IntrospectableMcpServer): {
+    tools: ToolSpec[];
+    resources: ResourceSpec[];
+    prompts: PromptSpec[];
+};
+export {};
+//# sourceMappingURL=introspection.d.ts.map

package/dist/introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.d.ts","sourceRoot":"","sources":["../src/introspection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,yCAAyC,CAAC;AAYjD;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;IACpD;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAKpD;;OAEG;IACH,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAK5D;;OAEG;IACH,8BAA8B,IAAI,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAK5E;;OAEG;IACH,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;CAIzD;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,GAAG,QAAQ,EAAE,CAc5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,GAC9B,YAAY,EAAE,CAkBhB;AAsDD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,uBAAuB,GAC9B,UAAU,EAAE,CAmBd;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,uBAAuB;;;;EAM1D"}

package/dist/introspection.js

@@ -0,0 +1,135 @@
+/**
+ * Introspection utilities for extracting specifications from MCP Server
+ */
+import { McpServer, } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Extended McpServer with introspection capabilities.
+ * Provides access to registered tools, resources, and prompts for spec extraction.
+ */
+export class IntrospectableMcpServer extends McpServer {
+    /**
+     * Get all registered tools with their metadata
+     */
+    getRegisteredTools() {
+        // Access the private _registeredTools field (it's an object, not a Map)
+        return this._registeredTools;
+    }
+    /**
+     * Get all registered resources with their metadata
+     */
+    getRegisteredResources() {
+        // Access the private _registeredResources field (it's an object, not a Map)
+        return this._registeredResources;
+    }
+    /**
+     * Get all registered resource templates with their metadata
+     */
+    getRegisteredResourceTemplates() {
+        // Access the private _registeredResourceTemplates field (it's an object, not a Map)
+        return this._registeredResourceTemplates;
+    }
+    /**
+     * Get all registered prompts with their metadata
+     */
+    getRegisteredPrompts() {
+        // Access the private _registeredPrompts field (it's an object, not a Map)
+        return this._registeredPrompts;
+    }
+}
+/**
+ * Extract tool specifications from an introspectable server
+ */
+export function extractToolsSpec(server) {
+    const tools = [];
+    const registeredTools = server.getRegisteredTools();
+    for (const [name, tool] of Object.entries(registeredTools)) {
+        if (tool.enabled) {
+            tools.push({
+                name,
+                description: tool.description || "",
+            });
+        }
+    }
+    return tools.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Extract resource specifications from an introspectable server
+ */
+export function extractResourcesSpec(server) {
+    const resources = [];
+    const registeredResources = server.getRegisteredResources();
+    for (const [uri, resource] of Object.entries(registeredResources)) {
+        if (resource.enabled) {
+            resources.push({
+                name: resource.name,
+                uri,
+                mimeType: resource.metadata?.mimeType || "text/plain",
+            });
+        }
+    }
+    // Note: Resource templates are not included in static spec extraction
+    // as they represent dynamic URI patterns
+    return resources.sort((a, b) => a.uri.localeCompare(b.uri));
+}
+/**
+ * Extract argument specifications from Zod schema
+ */
+function extractPromptArgs(argsSchema) {
+    if (!argsSchema || !argsSchema._def) {
+        return [];
+    }
+    const args = [];
+    // Handle Zod object schema
+    if (argsSchema._def.typeName === "ZodObject") {
+        const shape = argsSchema._def.shape?.();
+        if (shape) {
+            for (const [argName, argSchema] of Object.entries(shape)) {
+                // Check if the argument is optional
+                const isOptional = argSchema._def.typeName === "ZodOptional";
+                const innerSchema = isOptional ? argSchema._def.innerType : argSchema;
+                // Extract description from the schema
+                let description = "";
+                if (innerSchema?._def.description) {
+                    description = innerSchema._def.description;
+                }
+                args.push({
+                    name: argName,
+                    description,
+                    required: !isOptional,
+                });
+            }
+        }
+    }
+    return args;
+}
+/**
+ * Extract prompt specifications from an introspectable server
+ */
+export function extractPromptsSpec(server) {
+    const prompts = [];
+    const registeredPrompts = server.getRegisteredPrompts();
+    for (const [name, prompt] of Object.entries(registeredPrompts)) {
+        if (prompt.enabled) {
+            const args = prompt.argsSchema
+                ? extractPromptArgs(prompt.argsSchema)
+                : [];
+            prompts.push({
+                name,
+                description: prompt.description || "",
+                arguments: args,
+            });
+        }
+    }
+    return prompts.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Extract full specification from an introspectable server
+ */
+export function extractSpec(server) {
+    return {
+        tools: extractToolsSpec(server),
+        resources: extractResourcesSpec(server),
+        prompts: extractPromptsSpec(server),
+    };
+}
+//# sourceMappingURL=introspection.js.map

package/dist/introspection.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Server setup for MCP Test Kits
+ */
+import { Config } from "./config.js";
+import { IntrospectableMcpServer } from "./introspection.js";
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(config: Config): IntrospectableMcpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAK7D;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAoBpE"}

package/dist/server.js

@@ -0,0 +1,28 @@
+/**
+ * MCP Server setup for MCP Test Kits
+ */
+import { IntrospectableMcpServer } from "./introspection.js";
+import { registerTools } from "./capabilities/tools.js";
+import { registerResources } from "./capabilities/resources.js";
+import { registerPrompts } from "./capabilities/prompts.js";
+/**
+ * Create and configure the MCP server
+ */
+export function createServer(config) {
+    const server = new IntrospectableMcpServer({
+        name: config.server.name,
+        version: config.server.version,
+    });
+    // Register capabilities based on config
+    if (config.capabilities.tools) {
+        registerTools(server);
+    }
+    if (config.capabilities.resources) {
+        registerResources(server);
+    }
+    if (config.capabilities.prompts) {
+        registerPrompts(server);
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,MAAM,GAAG,IAAI,uBAAuB,CAAC;QACzC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;QACxB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;KAC/B,CAAC,CAAC;IAEH,wCAAwC;IACxC,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC9B,aAAa,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QAClC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAChC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/transports/http.d.ts

@@ -0,0 +1,10 @@
+/**
+ * HTTP transport for MCP Test Kits (Streamable HTTP)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Config } from "../config.js";
+/**
+ * Run the MCP server over HTTP transport (Streamable HTTP)
+ */
+export declare function runHttpServer(server: McpServer, config: Config): Promise<void>;
+//# sourceMappingURL=http.d.ts.map

package/dist/transports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transports/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/transports/http.js

@@ -0,0 +1,31 @@
+/**
+ * HTTP transport for MCP Test Kits (Streamable HTTP)
+ */
+import express from "express";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+/**
+ * Run the MCP server over HTTP transport (Streamable HTTP)
+ */
+export async function runHttpServer(server, config) {
+    const { host, port } = config.transport.network;
+    const app = express();
+    app.use(express.json());
+    // MCP endpoint - handle all HTTP methods
+    app.all("/mcp", async (req, res) => {
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+            enableJsonResponse: true,
+        });
+        res.on("close", () => transport.close());
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    });
+    // Start server
+    console.error(`Starting MCP HTTP server at http://${host}:${port}/mcp`);
+    app.listen(port, host, () => {
+        console.error(`MCP HTTP server listening on http://${host}:${port}`);
+    });
+    // Keep the process running
+    await new Promise(() => { });
+}
+//# sourceMappingURL=http.js.map

package/dist/transports/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/transports/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAGnG;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAiB,EACjB,MAAc;IAEd,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;IAEhD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,yCAAyC;IACzC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACjC,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;YAClD,kBAAkB,EAAE,SAAS;YAC7B,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC;IACxE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,uCAAuC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/dist/transports/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Transport modules for MCP Test Kits
+ */
+export { runStdioServer } from "./stdio.js";
+export { runHttpServer } from "./http.js";
+export { runSseServer } from "./sse.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transports/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/transports/index.js

@@ -0,0 +1,7 @@
+/**
+ * Transport modules for MCP Test Kits
+ */
+export { runStdioServer } from "./stdio.js";
+export { runHttpServer } from "./http.js";
+export { runSseServer } from "./sse.js";
+//# sourceMappingURL=index.js.map

package/dist/transports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transports/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/transports/sse.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SSE transport for MCP Test Kits
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Config } from "../config.js";
+/**
+ * Run the MCP server over SSE transport
+ */
+export declare function runSseServer(server: McpServer, config: Config): Promise<void>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/transports/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/transports/sse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/transports/sse.js

@@ -0,0 +1,44 @@
+/**
+ * SSE transport for MCP Test Kits
+ */
+import express from "express";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+/**
+ * Run the MCP server over SSE transport
+ */
+export async function runSseServer(server, config) {
+    const { host, port } = config.transport.network;
+    const app = express();
+    app.use(express.json());
+    // Store active transports for session management
+    const transports = new Map();
+    // SSE endpoint for server->client messages
+    app.get("/sse", async (req, res) => {
+        const transport = new SSEServerTransport("/sse", res);
+        const sessionId = transport.sessionId;
+        transports.set(sessionId, transport);
+        // Cleanup on close
+        transport.onclose = () => {
+            transports.delete(sessionId);
+        };
+        await server.connect(transport);
+    });
+    // POST endpoint for client->server messages
+    app.post("/sse", async (req, res) => {
+        const sessionId = req.query.sessionId;
+        if (!sessionId || !transports.has(sessionId)) {
+            res.status(400).json({ error: "Invalid or missing session ID" });
+            return;
+        }
+        const transport = transports.get(sessionId);
+        await transport.handlePostMessage(req, res, req.body);
+    });
+    // Start server
+    console.error(`Starting MCP SSE server at http://${host}:${port}/sse`);
+    app.listen(port, host, () => {
+        console.error(`MCP SSE server listening on http://${host}:${port}`);
+    });
+    // Keep the process running
+    await new Promise(() => { });
+}
+//# sourceMappingURL=sse.js.map

package/dist/transports/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/transports/sse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAiB,EACjB,MAAc;IAEd,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;IAEhD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,iDAAiD;IACjD,MAAM,UAAU,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEzD,2CAA2C;IAC3C,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACjC,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;QACtC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAErC,mBAAmB;QACnB,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;YACvB,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAA+B,CAAC;QAE5D,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QAC7C,MAAM,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC;IACvE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,sCAAsC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/dist/transports/stdio.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Stdio transport for MCP Test Kits
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Config } from "../config.js";
+/**
+ * Run the MCP server over stdio transport
+ */
+export declare function runStdioServer(server: McpServer, _config: Config): Promise<void>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/transports/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/transports/stdio.js

@@ -0,0 +1,14 @@
+/**
+ * Stdio transport for MCP Test Kits
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+/**
+ * Run the MCP server over stdio transport
+ */
+export async function runStdioServer(server, _config) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Keep the process running
+    await new Promise(() => { });
+}
+//# sourceMappingURL=stdio.js.map

package/dist/transports/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,2BAA2B;IAC3B,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/eslint.config.js

@@ -0,0 +1,22 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+    js.configs.recommended,
+    ...tseslint.configs.recommended,
+    {
+        files: ['src/**/*.ts'],
+        languageOptions: {
+            parserOptions: {
+                project: './tsconfig.json',
+            },
+        },
+        rules: {
+            '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+            '@typescript-eslint/no-explicit-any': 'off',
+        },
+    },
+    {
+        ignores: ['dist/**', 'node_modules/**'],
+    }
+);

package/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "mcp-test-kits",
+    "version": "0.0.0",
+    "description": "A comprehensive MCP testing server for debugging and testing MCP clients",
+    "author": "midodimori",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/midodimori/mcp-test-kits"
+    },
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "mcp-test-kits": "./dist/index.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsx src/index.ts",
+        "start": "node dist/index.js",
+        "test": "vitest run",
+        "lint": "eslint src/",
+        "lint:fix": "eslint src/ --fix && prettier --write src/",
+        "typecheck": "tsc --noEmit"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "testing",
+        "ai",
+        "llm"
+    ],
+    "license": "MIT",
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.0.0",
+        "express": "^4.21.0",
+        "zod": "^3.23.0"
+    },
+    "devDependencies": {
+        "@eslint/js": "^9.17.0",
+        "@types/express": "^4.17.21",
+        "@types/node": "^22.0.0",
+        "eslint": "^9.17.0",
+        "prettier": "^3.4.0",
+        "tsx": "^4.19.0",
+        "typescript": "^5.9.3",
+        "typescript-eslint": "^8.18.2",
+        "vitest": "^2.0.0"
+    }
+}