mcp-apps-testing 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aviv Eldan
+
+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,159 @@
+# mcp-apps-testing
+
+**The first UI testing framework built specifically for Model Context Protocol applications.** Test your MCP apps exactly how users experience them—with real browser rendering, simulated IDE environments, and complete JSON-RPC message control.
+
+![Hello World App](docs/images/hello-world-result.png)
+
+## Why mcp-apps-testing?
+
+Building MCP applications? You need to test more than just the protocol—you need to verify UI rendering, sandboxing behavior, and real-world interactions across different host environments (Claude, VS Code, etc.). **This is the framework that does all three.**
+
+**Zero-Config Testing**
+```typescript
+const host = new MockMCPHost({ hostProfile: 'Claude' });
+await host.callTool('greet', { name: 'World' });
+```
+
+**What Makes It Unique**
+- **Host Simulation**: Test against Claude, VS Code, or custom IDE profiles with different capabilities and themes
+- **Full Control**: Mock, intercept, and assert on every JSON-RPC message
+- **UI + Protocol**: Tests both UI rendering AND protocol interactions in a single framework
+- **Fluent API**: Human-readable test code with auto-retry and intelligent defaults
+
+## Quick Start
+
+### Installation
+
+Install the package along with its peer dependency:
+
+```bash
+npm install mcp-apps-testing @playwright/test --save-dev
+npx playwright install chromium
+```
+
+**Write Your First Test**
+```typescript
+import { test, expect } from '@playwright/test';
+import { MockMCPHost } from 'mcp-apps-testing';
+
+test('MCP app responds to tool calls', async () => {
+  const host = new MockMCPHost({ hostProfile: 'Claude' });
+  
+  // Mock the tool response
+  host.getInterceptor().mockResponse('tools/call', (req) => ({
+    jsonrpc: '2.0',
+    id: req.id,
+    result: { content: [{ type: 'text', text: 'Hello, World!' }] }
+  }));
+  
+  // Call the tool with fluent API
+  const response = await host.callTool('greet', { name: 'World' });
+  expect(response.result.content[0].text).toBe('Hello, World!');
+  
+  await host.cleanup();
+});
+```
+
+**Run tests**: `npm test`
+
+## Key Features
+
+### Simulate Real IDE Environments
+Test your MCP app against different host profiles with specific capabilities, themes, and constraints:
+```typescript
+new MockMCPHost({ hostProfile: 'Claude' })  // Full MCP capabilities
+new MockMCPHost({ hostProfile: 'VSCode' })  // Editor-specific constraints
+```
+
+### Complete Message Control
+Mock, intercept, and record every JSON-RPC interaction:
+```typescript
+// Mock responses
+host.getInterceptor().mockResponse('tools/call', yourHandler);
+
+// Record and assert
+const requests = host.getInterceptor().getRecordedRequests();
+expect(requests[0].method).toBe('initialize');
+```
+
+### Test UI + Protocol Together
+Validate both visual rendering AND protocol behavior in the same test:
+```typescript
+// Test UI rendering
+await page.goto('your-mcp-app.html');
+await expect(page.locator('h1')).toBeVisible();
+
+// Test protocol interaction  
+const response = await host.callTool('greet', { name: 'Test' });
+```
+
+## Architecture
+
+![Architecture Diagram](docs/images/architecture.svg)
+
+**Core Components**
+- **MockMCPHost**: Simulates IDE hosting environment with auto-response to common protocol messages
+- **TransportInterceptor**: Mocks and records JSON-RPC messages for testing and assertions
+- **Host Profiles**: Pre-configured environments (Claude, VS Code, Generic) with capabilities and themes
+
+## Examples
+
+See the [examples/](examples/) directory for complete working examples:
+- **hello-world.spec.ts**: Full UI testing with theme switching and tool calls
+- **basic-test.spec.ts**: Protocol-focused testing with message mocking
+
+![Test Results](docs/images/test-results.svg)
+
+## Documentation
+
+- [Getting Started Guide](docs/getting-started.md) - Detailed setup and first steps
+- [API Reference](docs/api-reference.md) - Complete API documentation
+- [Example App](examples/hello-world-app.html) - Sample MCP application
+
+## Commands
+
+```bash
+npm test              # Run all tests
+npm run test:ui       # Run with Playwright UI
+npm run build         # Build the framework
+npm run dev           # Development mode with watch
+```
+
+## Publishing
+
+This package is automatically published to npm via GitHub Actions when a new release is created.
+
+### Publishing a New Version
+
+1. Update the version in `package.json` following [semantic versioning](https://semver.org/)
+2. Commit and push the version change
+3. Create a new GitHub release with a tag matching the version (e.g., `v0.1.0`)
+4. The GitHub Actions workflow will automatically:
+   - Build the package
+   - Run tests
+   - Publish to npm using the `NPM_PAT` secret from the `npm-publish` environment
+
+### Manual Publishing (if needed)
+
+To publish manually:
+```bash
+npm run build
+npm test
+npm publish
+```
+
+The `prepublishOnly` script ensures a clean build is created before publishing.
+
+## Contributing
+
+This framework is designed for professional MCP UI application testing. Contributions should maintain the modular architecture and focus on core testing capabilities.
+
+## License
+
+MIT
+
+---
+
+**Built with:** TypeScript • Playwright • [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)
+
+**Learn more:** [Model Context Protocol](https://modelcontextprotocol.io/) • [Playwright](https://playwright.dev/)

package/dist/core/HostProfiles.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Host Profiles - Simulates different MCP host environments
+ *
+ * This module provides pre-configured profiles for different AI host environments
+ * like Claude, VS Code, etc., including their specific capabilities, theme variables,
+ * and constraints.
+ */
+export interface HostProfile {
+    name: string;
+    capabilities: {
+        tools?: {
+            listChanged?: boolean;
+        };
+        resources?: {
+            subscribe?: boolean;
+            listChanged?: boolean;
+        };
+        prompts?: {
+            listChanged?: boolean;
+        };
+    };
+    theme: {
+        light: Record<string, string>;
+        dark: Record<string, string>;
+    };
+    constraints?: {
+        maxViewportWidth?: number;
+        maxViewportHeight?: number;
+        allowedProtocols?: string[];
+    };
+}
+/**
+ * Claude AI host profile
+ */
+export declare const ClaudeProfile: HostProfile;
+/**
+ * VS Code host profile
+ */
+export declare const VSCodeProfile: HostProfile;
+/**
+ * Generic host profile (default)
+ */
+export declare const GenericProfile: HostProfile;
+/**
+ * Available host profiles
+ */
+export declare const HostProfiles: {
+    readonly Claude: HostProfile;
+    readonly VSCode: HostProfile;
+    readonly Generic: HostProfile;
+};
+/**
+ * Apply theme CSS variables to a page or element
+ */
+export declare function applyTheme(profile: HostProfile, mode?: 'light' | 'dark'): string;
+//# sourceMappingURL=HostProfiles.d.ts.map

package/dist/core/HostProfiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostProfiles.d.ts","sourceRoot":"","sources":["../../src/core/HostProfiles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE;QACZ,KAAK,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAClC,SAAS,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAC3D,OAAO,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACrC,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC9B,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC7B,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAgC3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAgC3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WA2B5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,WAAW,EACpB,IAAI,GAAE,OAAO,GAAG,MAAgB,GAC/B,MAAM,CAKR"}

package/dist/core/HostProfiles.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * Host Profiles - Simulates different MCP host environments
+ *
+ * This module provides pre-configured profiles for different AI host environments
+ * like Claude, VS Code, etc., including their specific capabilities, theme variables,
+ * and constraints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HostProfiles = exports.GenericProfile = exports.VSCodeProfile = exports.ClaudeProfile = void 0;
+exports.applyTheme = applyTheme;
+/**
+ * Claude AI host profile
+ */
+exports.ClaudeProfile = {
+    name: 'Claude',
+    capabilities: {
+        tools: { listChanged: true },
+        resources: { subscribe: true, listChanged: true },
+        prompts: { listChanged: true },
+    },
+    theme: {
+        light: {
+            '--background': '#ffffff',
+            '--foreground': '#1a1a1a',
+            '--primary': '#6366f1',
+            '--secondary': '#8b5cf6',
+            '--accent': '#ec4899',
+            '--muted': '#f3f4f6',
+            '--border': '#e5e7eb',
+        },
+        dark: {
+            '--background': '#1a1a1a',
+            '--foreground': '#ffffff',
+            '--primary': '#818cf8',
+            '--secondary': '#a78bfa',
+            '--accent': '#f472b6',
+            '--muted': '#374151',
+            '--border': '#4b5563',
+        },
+    },
+    constraints: {
+        maxViewportWidth: 1920,
+        maxViewportHeight: 1080,
+        allowedProtocols: ['http', 'https', 'data'],
+    },
+};
+/**
+ * VS Code host profile
+ */
+exports.VSCodeProfile = {
+    name: 'VS Code',
+    capabilities: {
+        tools: { listChanged: true },
+        resources: { subscribe: false, listChanged: true },
+        prompts: { listChanged: false },
+    },
+    theme: {
+        light: {
+            '--background': '#ffffff',
+            '--foreground': '#333333',
+            '--primary': '#007acc',
+            '--secondary': '#68217a',
+            '--accent': '#0098ff',
+            '--muted': '#f3f3f3',
+            '--border': '#cccccc',
+        },
+        dark: {
+            '--background': '#1e1e1e',
+            '--foreground': '#cccccc',
+            '--primary': '#0098ff',
+            '--secondary': '#c586c0',
+            '--accent': '#4fc1ff',
+            '--muted': '#2d2d2d',
+            '--border': '#3e3e3e',
+        },
+    },
+    constraints: {
+        maxViewportWidth: 1600,
+        maxViewportHeight: 900,
+        allowedProtocols: ['http', 'https', 'vscode', 'data'],
+    },
+};
+/**
+ * Generic host profile (default)
+ */
+exports.GenericProfile = {
+    name: 'Generic',
+    capabilities: {
+        tools: { listChanged: true },
+        resources: { subscribe: true, listChanged: true },
+        prompts: { listChanged: true },
+    },
+    theme: {
+        light: {
+            '--background': '#ffffff',
+            '--foreground': '#000000',
+            '--primary': '#0066cc',
+            '--secondary': '#6600cc',
+            '--accent': '#cc0066',
+            '--muted': '#f5f5f5',
+            '--border': '#dddddd',
+        },
+        dark: {
+            '--background': '#000000',
+            '--foreground': '#ffffff',
+            '--primary': '#3399ff',
+            '--secondary': '#9933ff',
+            '--accent': '#ff3399',
+            '--muted': '#333333',
+            '--border': '#555555',
+        },
+    },
+};
+/**
+ * Available host profiles
+ */
+exports.HostProfiles = {
+    Claude: exports.ClaudeProfile,
+    VSCode: exports.VSCodeProfile,
+    Generic: exports.GenericProfile,
+};
+/**
+ * Apply theme CSS variables to a page or element
+ */
+function applyTheme(profile, mode = 'light') {
+    const themeVars = profile.theme[mode];
+    return Object.entries(themeVars)
+        .map(([key, value]) => `${key}: ${value};`)
+        .join('\n');
+}
+//# sourceMappingURL=HostProfiles.js.map

package/dist/core/HostProfiles.js.map

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

package/dist/core/MockMCPHost.d.ts

@@ -0,0 +1,108 @@
+import { TransportInterceptor } from './TransportInterceptor';
+import { MockMCPHostConfig, MCPCapabilities, JSONRPCRequest, JSONRPCResponse } from '../types';
+import { HostProfile } from './HostProfiles';
+/**
+ * MockMCPHost - Simulates an IDE environment hosting an MCP server
+ *
+ * This class provides:
+ * - A simulated MCP host environment for testing
+ * - Automatic handling of common MCP protocol messages
+ * - Integration with TransportInterceptor for request/response mocking
+ * - Capability simulation (tools, resources, prompts)
+ * - Host profile simulation (Claude, VS Code, etc.)
+ */
+export declare class MockMCPHost {
+    private interceptor;
+    private config;
+    private capabilities;
+    private initialized;
+    private requestIdCounter;
+    private hostProfile;
+    constructor(config?: MockMCPHostConfig);
+    /**
+     * Load a host profile
+     */
+    private loadHostProfile;
+    /**
+     * Get the current host profile
+     */
+    getHostProfile(): HostProfile | null;
+    /**
+     * Get the transport interceptor
+     */
+    getInterceptor(): TransportInterceptor;
+    /**
+     * Set up automatic responses for common MCP protocol messages
+     */
+    private setupAutoResponders;
+    /**
+     * Set capabilities that this host supports
+     */
+    setCapabilities(capabilities: MCPCapabilities): void;
+    /**
+     * Send a request to the server (simulate client -> server)
+     */
+    sendRequest(method: string, params?: unknown): Promise<JSONRPCResponse>;
+    /**
+     * Initialize the MCP connection
+     */
+    initialize(clientInfo?: {
+        name: string;
+        version: string;
+    }): Promise<JSONRPCResponse>;
+    /**
+     * Check if the host is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Cleanup and reset the host
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get all recorded messages from the interceptor
+     */
+    getRecordedMessages(): (JSONRPCRequest | JSONRPCResponse | import("../types").JSONRPCNotification)[];
+    /**
+     * Clear recorded messages
+     */
+    clearRecordedMessages(): void;
+    /**
+     * Fluent DSL: Call a tool with automatic response handling
+     * @param name Tool name
+     * @param args Tool arguments
+     * @param options Optional retry and timeout settings
+     */
+    callTool(name: string, args?: Record<string, unknown>, options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<JSONRPCResponse>;
+    /**
+     * Fluent DSL: List available tools
+     */
+    listTools(): Promise<JSONRPCResponse>;
+    /**
+     * Fluent DSL: Read a resource
+     * @param uri Resource URI
+     */
+    readResource(uri: string): Promise<JSONRPCResponse>;
+    /**
+     * Fluent DSL: List available resources
+     */
+    listResources(): Promise<JSONRPCResponse>;
+    /**
+     * Fluent DSL: Get a prompt
+     * @param name Prompt name
+     * @param args Prompt arguments
+     */
+    getPrompt(name: string, args?: Record<string, unknown>): Promise<JSONRPCResponse>;
+    /**
+     * Fluent DSL: List available prompts
+     */
+    listPrompts(): Promise<JSONRPCResponse>;
+    /**
+     * Enable protocol logging for debugging
+     */
+    private protocolLoggingEnabled;
+    enableProtocolLogging(): void;
+}
+//# sourceMappingURL=MockMCPHost.d.ts.map

package/dist/core/MockMCPHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockMCPHost.d.ts","sourceRoot":"","sources":["../../src/core/MockMCPHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC/F,OAAO,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,WAAW,CAA4B;gBAEnC,MAAM,GAAE,iBAAsB;IAoB1C;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC;;OAEG;IACH,cAAc,IAAI,oBAAoB;IAItC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqD3B;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI;IAIpD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IA8B7E;;OAEG;IACG,UAAU,CAAC,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAW1F;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B;;OAEG;IACH,mBAAmB;IAInB;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAI7B;;;;;OAKG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GACnD,OAAO,CAAC,eAAe,CAAC;IA6B3B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAI3C;;;OAGG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAI/C;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI3F;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAI7C;;OAEG;IACH,OAAO,CAAC,sBAAsB,CAAS;IAEvC,qBAAqB,IAAI,IAAI;CAkB9B"}

package/dist/core/MockMCPHost.js

@@ -0,0 +1,265 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockMCPHost = void 0;
+const TransportInterceptor_1 = require("./TransportInterceptor");
+const HostProfiles_1 = require("./HostProfiles");
+/**
+ * MockMCPHost - Simulates an IDE environment hosting an MCP server
+ *
+ * This class provides:
+ * - A simulated MCP host environment for testing
+ * - Automatic handling of common MCP protocol messages
+ * - Integration with TransportInterceptor for request/response mocking
+ * - Capability simulation (tools, resources, prompts)
+ * - Host profile simulation (Claude, VS Code, etc.)
+ */
+class MockMCPHost {
+    constructor(config = {}) {
+        this.initialized = false;
+        this.requestIdCounter = 0;
+        this.hostProfile = null;
+        /**
+         * Enable protocol logging for debugging
+         */
+        this.protocolLoggingEnabled = false;
+        this.config = {
+            autoRespond: true,
+            debug: false,
+            ...config,
+        };
+        this.interceptor = new TransportInterceptor_1.TransportInterceptor(this.config.debug);
+        this.capabilities = {};
+        // Load host profile if specified
+        if (this.config.hostProfile) {
+            this.loadHostProfile(this.config.hostProfile);
+        }
+        if (this.config.autoRespond) {
+            this.setupAutoResponders();
+        }
+    }
+    /**
+     * Load a host profile
+     */
+    loadHostProfile(profileName) {
+        const profile = HostProfiles_1.HostProfiles[profileName];
+        if (profile) {
+            this.hostProfile = profile;
+            this.capabilities = profile.capabilities;
+        }
+    }
+    /**
+     * Get the current host profile
+     */
+    getHostProfile() {
+        return this.hostProfile;
+    }
+    /**
+     * Get the transport interceptor
+     */
+    getInterceptor() {
+        return this.interceptor;
+    }
+    /**
+     * Set up automatic responses for common MCP protocol messages
+     */
+    setupAutoResponders() {
+        // Auto-respond to initialize requests
+        this.interceptor.mockResponse('initialize', (request) => {
+            this.initialized = true;
+            return {
+                jsonrpc: '2.0',
+                id: request.id,
+                result: {
+                    protocolVersion: '2024-11-05',
+                    capabilities: this.capabilities,
+                    serverInfo: {
+                        name: 'mock-mcp-server',
+                        version: '0.1.0',
+                    },
+                },
+            };
+        });
+        // Auto-respond to ping requests
+        this.interceptor.mockResponse('ping', (request) => ({
+            jsonrpc: '2.0',
+            id: request.id,
+            result: {},
+        }));
+        // Auto-respond to tools/list requests
+        this.interceptor.mockResponse('tools/list', (request) => ({
+            jsonrpc: '2.0',
+            id: request.id,
+            result: {
+                tools: [],
+            },
+        }));
+        // Auto-respond to resources/list requests
+        this.interceptor.mockResponse('resources/list', (request) => ({
+            jsonrpc: '2.0',
+            id: request.id,
+            result: {
+                resources: [],
+            },
+        }));
+        // Auto-respond to prompts/list requests
+        this.interceptor.mockResponse('prompts/list', (request) => ({
+            jsonrpc: '2.0',
+            id: request.id,
+            result: {
+                prompts: [],
+            },
+        }));
+    }
+    /**
+     * Set capabilities that this host supports
+     */
+    setCapabilities(capabilities) {
+        this.capabilities = capabilities;
+    }
+    /**
+     * Send a request to the server (simulate client -> server)
+     */
+    async sendRequest(method, params) {
+        const request = {
+            jsonrpc: '2.0',
+            id: ++this.requestIdCounter,
+            method,
+            params,
+        };
+        // Intercept the request
+        const interceptedRequest = await this.interceptor.interceptRequest(request);
+        // Check if we should mock the response
+        const mockResponse = await this.interceptor.shouldMock(interceptedRequest);
+        if (mockResponse) {
+            return await this.interceptor.interceptResponse(mockResponse);
+        }
+        // If no mock, return an error
+        const errorResponse = {
+            jsonrpc: '2.0',
+            id: interceptedRequest.id,
+            error: {
+                code: -32601,
+                message: `Method not found: ${method}`,
+            },
+        };
+        return await this.interceptor.interceptResponse(errorResponse);
+    }
+    /**
+     * Initialize the MCP connection
+     */
+    async initialize(clientInfo) {
+        return await this.sendRequest('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: clientInfo || {
+                name: 'mock-client',
+                version: '0.1.0',
+            },
+        });
+    }
+    /**
+     * Check if the host is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Cleanup and reset the host
+     */
+    async cleanup() {
+        this.interceptor.reset();
+        this.initialized = false;
+        this.requestIdCounter = 0;
+    }
+    /**
+     * Get all recorded messages from the interceptor
+     */
+    getRecordedMessages() {
+        return this.interceptor.getRecordedMessages();
+    }
+    /**
+     * Clear recorded messages
+     */
+    clearRecordedMessages() {
+        this.interceptor.clearRecordedMessages();
+    }
+    /**
+     * Fluent DSL: Call a tool with automatic response handling
+     * @param name Tool name
+     * @param args Tool arguments
+     * @param options Optional retry and timeout settings
+     */
+    async callTool(name, args = {}, options = {}) {
+        const { timeout = 5000, retries = 3 } = options;
+        let lastError = null;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                const response = await Promise.race([
+                    this.sendRequest('tools/call', { name, arguments: args }),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Tool call timeout')), timeout)),
+                ]);
+                if (response.error) {
+                    throw new Error(response.error.message);
+                }
+                return response;
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < retries) {
+                    await new Promise(resolve => setTimeout(resolve, 100 * (attempt + 1)));
+                }
+            }
+        }
+        throw new Error(`Tool call failed after ${retries + 1} attempts: ${lastError?.message}`);
+    }
+    /**
+     * Fluent DSL: List available tools
+     */
+    async listTools() {
+        return await this.sendRequest('tools/list');
+    }
+    /**
+     * Fluent DSL: Read a resource
+     * @param uri Resource URI
+     */
+    async readResource(uri) {
+        return await this.sendRequest('resources/read', { uri });
+    }
+    /**
+     * Fluent DSL: List available resources
+     */
+    async listResources() {
+        return await this.sendRequest('resources/list');
+    }
+    /**
+     * Fluent DSL: Get a prompt
+     * @param name Prompt name
+     * @param args Prompt arguments
+     */
+    async getPrompt(name, args = {}) {
+        return await this.sendRequest('prompts/get', { name, arguments: args });
+    }
+    /**
+     * Fluent DSL: List available prompts
+     */
+    async listPrompts() {
+        return await this.sendRequest('prompts/list');
+    }
+    enableProtocolLogging() {
+        // Prevent duplicate logging interceptors
+        if (this.protocolLoggingEnabled) {
+            return;
+        }
+        this.protocolLoggingEnabled = true;
+        this.interceptor.onRequest(async (request) => {
+            console.log('[MCP Request]', JSON.stringify(request, null, 2));
+            return request;
+        });
+        this.interceptor.onResponse(async (response) => {
+            console.log('[MCP Response]', JSON.stringify(response, null, 2));
+            return response;
+        });
+    }
+}
+exports.MockMCPHost = MockMCPHost;
+//# sourceMappingURL=MockMCPHost.js.map

package/dist/core/MockMCPHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockMCPHost.js","sourceRoot":"","sources":["../../src/core/MockMCPHost.ts"],"names":[],"mappings":";;;AAAA,iEAA8D;AAE9D,iDAA2D;AAE3D;;;;;;;;;GASG;AACH,MAAa,WAAW;IAQtB,YAAY,SAA4B,EAAE;QAJlC,gBAAW,GAAG,KAAK,CAAC;QACpB,qBAAgB,GAAG,CAAC,CAAC;QACrB,gBAAW,GAAuB,IAAI,CAAC;QAwQ/C;;WAEG;QACK,2BAAsB,GAAG,KAAK,CAAC;QAxQrC,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,KAAK;YACZ,GAAG,MAAM;SACV,CAAC;QAEF,IAAI,CAAC,WAAW,GAAG,IAAI,2CAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QAEvB,iCAAiC;QACjC,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5B,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,WAAmB;QACzC,MAAM,OAAO,GAAG,2BAAY,CAAC,WAAwC,CAAC,CAAC;QACvE,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;YAC3B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,sCAAsC;QACtC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,OAAuB,EAAE,EAAE;YACtE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,MAAM,EAAE;oBACN,eAAe,EAAE,YAAY;oBAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,UAAU,EAAE;wBACV,IAAI,EAAE,iBAAiB;wBACvB,OAAO,EAAE,OAAO;qBACjB;iBACF;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,gCAAgC;QAChC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,OAAuB,EAAE,EAAE,CAAC,CAAC;YAClE,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,MAAM,EAAE,EAAE;SACX,CAAC,CAAC,CAAC;QAEJ,sCAAsC;QACtC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,OAAuB,EAAE,EAAE,CAAC,CAAC;YACxE,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,MAAM,EAAE;gBACN,KAAK,EAAE,EAAE;aACV;SACF,CAAC,CAAC,CAAC;QAEJ,0CAA0C;QAC1C,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC,OAAuB,EAAE,EAAE,CAAC,CAAC;YAC5E,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,MAAM,EAAE;gBACN,SAAS,EAAE,EAAE;aACd;SACF,CAAC,CAAC,CAAC;QAEJ,wCAAwC;QACxC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,OAAuB,EAAE,EAAE,CAAC,CAAC;YAC1E,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,EAAE;aACZ;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,YAA6B;QAC3C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,MAAgB;QAChD,MAAM,OAAO,GAAmB;YAC9B,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,EAAE,IAAI,CAAC,gBAAgB;YAC3B,MAAM;YACN,MAAM;SACP,CAAC;QAEF,wBAAwB;QACxB,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE5E,uCAAuC;QACvC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QAC3E,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAChE,CAAC;QAED,8BAA8B;QAC9B,MAAM,aAAa,GAAoB;YACrC,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,kBAAkB,CAAC,EAAE;YACzB,KAAK,EAAE;gBACL,IAAI,EAAE,CAAC,KAAK;gBACZ,OAAO,EAAE,qBAAqB,MAAM,EAAE;aACvC;SACF,CAAC;QAEF,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,UAA8C;QAC7D,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;YAC1C,eAAe,EAAE,YAAY;YAC7B,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,UAAU,IAAI;gBACxB,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,OAAO;aACjB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,OAAgC,EAAE,EAClC,UAAkD,EAAE;QAEpD,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;QAChD,IAAI,SAAS,GAAiB,IAAI,CAAC;QAEnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBAClC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;oBACzD,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC/B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC,CAClE;iBACF,CAAC,CAAC;gBAEH,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC1C,CAAC;gBAED,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAc,CAAC;gBAC3B,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;oBACtB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,GAAG,CAAC,cAAc,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,OAAgC,EAAE;QAC9D,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC;IAOD,qBAAqB;QACnB,yCAAyC;QACzC,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;QAEnC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC3C,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/D,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAC7C,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjE,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AArSD,kCAqSC"}

package/dist/core/TransportInterceptor.d.ts

@@ -0,0 +1,72 @@
+import { JSONRPCRequest, JSONRPCResponse, JSONRPCNotification, MessageHandler, RequestInterceptor, ResponseInterceptor } from '../types';
+/**
+ * TransportInterceptor - Intercepts and mocks JSON-RPC messages
+ *
+ * This class allows you to:
+ * - Intercept outgoing requests and modify them
+ * - Intercept incoming responses and modify them
+ * - Mock responses to specific requests
+ * - Record all messages for testing assertions
+ */
+export declare class TransportInterceptor {
+    private requestInterceptors;
+    private responseInterceptors;
+    private messageHandlers;
+    private requestMocks;
+    private recordedMessages;
+    private debug;
+    constructor(debug?: boolean);
+    /**
+     * Add a request interceptor
+     */
+    onRequest(interceptor: RequestInterceptor): void;
+    /**
+     * Add a response interceptor
+     */
+    onResponse(interceptor: ResponseInterceptor): void;
+    /**
+     * Add a message handler (for all messages)
+     */
+    onMessage(handler: MessageHandler): void;
+    /**
+     * Mock a response for a specific method
+     */
+    mockResponse(method: string, handler: (request: JSONRPCRequest) => JSONRPCResponse | Promise<JSONRPCResponse>): void;
+    /**
+     * Process an outgoing request
+     */
+    interceptRequest(request: JSONRPCRequest): Promise<JSONRPCRequest>;
+    /**
+     * Process an incoming response
+     */
+    interceptResponse(response: JSONRPCResponse): Promise<JSONRPCResponse>;
+    /**
+     * Check if a request should be mocked
+     */
+    shouldMock(request: JSONRPCRequest): Promise<JSONRPCResponse | null>;
+    /**
+     * Get all recorded messages
+     */
+    getRecordedMessages(): Array<JSONRPCRequest | JSONRPCResponse | JSONRPCNotification>;
+    /**
+     * Get recorded requests only
+     */
+    getRecordedRequests(): JSONRPCRequest[];
+    /**
+     * Get recorded responses only
+     */
+    getRecordedResponses(): JSONRPCResponse[];
+    /**
+     * Find requests by method name
+     */
+    findRequestsByMethod(method: string): JSONRPCRequest[];
+    /**
+     * Clear all recorded messages
+     */
+    clearRecordedMessages(): void;
+    /**
+     * Clear all interceptors and mocks
+     */
+    reset(): void;
+}
+//# sourceMappingURL=TransportInterceptor.d.ts.map

package/dist/core/TransportInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportInterceptor.d.ts","sourceRoot":"","sources":["../../src/core/TransportInterceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,YAAY,CAAmG;IACvH,OAAO,CAAC,gBAAgB,CAAqE;IAC7F,OAAO,CAAC,KAAK,CAAU;gBAEX,KAAK,UAAQ;IAIzB;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAIhD;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAIlD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAIpH;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAmBxE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAmB5E;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAW1E;;OAEG;IACH,mBAAmB,IAAI,KAAK,CAAC,cAAc,GAAG,eAAe,GAAG,mBAAmB,CAAC;IAIpF;;OAEG;IACH,mBAAmB,IAAI,cAAc,EAAE;IAIvC;;OAEG;IACH,oBAAoB,IAAI,eAAe,EAAE;IAIzC;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAItD;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAI7B;;OAEG;IACH,KAAK,IAAI,IAAI;CAOd"}

package/dist/core/TransportInterceptor.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportInterceptor = void 0;
+/**
+ * TransportInterceptor - Intercepts and mocks JSON-RPC messages
+ *
+ * This class allows you to:
+ * - Intercept outgoing requests and modify them
+ * - Intercept incoming responses and modify them
+ * - Mock responses to specific requests
+ * - Record all messages for testing assertions
+ */
+class TransportInterceptor {
+    constructor(debug = false) {
+        this.requestInterceptors = [];
+        this.responseInterceptors = [];
+        this.messageHandlers = [];
+        this.requestMocks = new Map();
+        this.recordedMessages = [];
+        this.debug = debug;
+    }
+    /**
+     * Add a request interceptor
+     */
+    onRequest(interceptor) {
+        this.requestInterceptors.push(interceptor);
+    }
+    /**
+     * Add a response interceptor
+     */
+    onResponse(interceptor) {
+        this.responseInterceptors.push(interceptor);
+    }
+    /**
+     * Add a message handler (for all messages)
+     */
+    onMessage(handler) {
+        this.messageHandlers.push(handler);
+    }
+    /**
+     * Mock a response for a specific method
+     */
+    mockResponse(method, handler) {
+        this.requestMocks.set(method, handler);
+    }
+    /**
+     * Process an outgoing request
+     */
+    async interceptRequest(request) {
+        if (this.debug) {
+            console.log('[TransportInterceptor] Outgoing request:', JSON.stringify(request, null, 2));
+        }
+        this.recordedMessages.push(request);
+        let modifiedRequest = request;
+        for (const interceptor of this.requestInterceptors) {
+            modifiedRequest = await interceptor(modifiedRequest);
+        }
+        for (const handler of this.messageHandlers) {
+            await handler(modifiedRequest);
+        }
+        return modifiedRequest;
+    }
+    /**
+     * Process an incoming response
+     */
+    async interceptResponse(response) {
+        if (this.debug) {
+            console.log('[TransportInterceptor] Incoming response:', JSON.stringify(response, null, 2));
+        }
+        this.recordedMessages.push(response);
+        let modifiedResponse = response;
+        for (const interceptor of this.responseInterceptors) {
+            modifiedResponse = await interceptor(modifiedResponse);
+        }
+        for (const handler of this.messageHandlers) {
+            await handler(modifiedResponse);
+        }
+        return modifiedResponse;
+    }
+    /**
+     * Check if a request should be mocked
+     */
+    async shouldMock(request) {
+        const mockHandler = this.requestMocks.get(request.method);
+        if (mockHandler) {
+            if (this.debug) {
+                console.log(`[TransportInterceptor] Mocking response for method: ${request.method}`);
+            }
+            return await mockHandler(request);
+        }
+        return null;
+    }
+    /**
+     * Get all recorded messages
+     */
+    getRecordedMessages() {
+        return [...this.recordedMessages];
+    }
+    /**
+     * Get recorded requests only
+     */
+    getRecordedRequests() {
+        return this.recordedMessages.filter(msg => 'method' in msg && 'id' in msg);
+    }
+    /**
+     * Get recorded responses only
+     */
+    getRecordedResponses() {
+        return this.recordedMessages.filter(msg => 'id' in msg && !('method' in msg));
+    }
+    /**
+     * Find requests by method name
+     */
+    findRequestsByMethod(method) {
+        return this.getRecordedRequests().filter(req => req.method === method);
+    }
+    /**
+     * Clear all recorded messages
+     */
+    clearRecordedMessages() {
+        this.recordedMessages = [];
+    }
+    /**
+     * Clear all interceptors and mocks
+     */
+    reset() {
+        this.requestInterceptors = [];
+        this.responseInterceptors = [];
+        this.messageHandlers = [];
+        this.requestMocks.clear();
+        this.recordedMessages = [];
+    }
+}
+exports.TransportInterceptor = TransportInterceptor;
+//# sourceMappingURL=TransportInterceptor.js.map

package/dist/core/TransportInterceptor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Apps Testing Framework
+ *
+ * A professional framework for testing Model Context Protocol (MCP) UI applications
+ * with Playwright. Bridge the gap between MCP protocol testing and UI rendering/iframe sandboxing.
+ */
+export { MockMCPHost } from './core/MockMCPHost';
+export { TransportInterceptor } from './core/TransportInterceptor';
+export { HostProfiles, ClaudeProfile, VSCodeProfile, GenericProfile, applyTheme } from './core/HostProfiles';
+export type { HostProfile } from './core/HostProfiles';
+export type { JSONRPCRequest, JSONRPCResponse, JSONRPCNotification, JSONRPCError, MessageHandler, RequestInterceptor, ResponseInterceptor, MockMCPHostConfig, MCPCapabilities, MCPTestContext, MCPTransport, } from './types';
+import type { MockMCPHostConfig, MCPTestContext } from './types';
+/**
+ * Create a test context with a mock MCP host
+ */
+export declare function createMCPTestContext(config?: MockMCPHostConfig): Promise<MCPTestContext>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7G,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,YAAY,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEjE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAY9F"}

package/dist/index.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * MCP Apps Testing Framework
+ *
+ * A professional framework for testing Model Context Protocol (MCP) UI applications
+ * with Playwright. Bridge the gap between MCP protocol testing and UI rendering/iframe sandboxing.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyTheme = exports.GenericProfile = exports.VSCodeProfile = exports.ClaudeProfile = exports.HostProfiles = exports.TransportInterceptor = exports.MockMCPHost = void 0;
+exports.createMCPTestContext = createMCPTestContext;
+var MockMCPHost_1 = require("./core/MockMCPHost");
+Object.defineProperty(exports, "MockMCPHost", { enumerable: true, get: function () { return MockMCPHost_1.MockMCPHost; } });
+var TransportInterceptor_1 = require("./core/TransportInterceptor");
+Object.defineProperty(exports, "TransportInterceptor", { enumerable: true, get: function () { return TransportInterceptor_1.TransportInterceptor; } });
+var HostProfiles_1 = require("./core/HostProfiles");
+Object.defineProperty(exports, "HostProfiles", { enumerable: true, get: function () { return HostProfiles_1.HostProfiles; } });
+Object.defineProperty(exports, "ClaudeProfile", { enumerable: true, get: function () { return HostProfiles_1.ClaudeProfile; } });
+Object.defineProperty(exports, "VSCodeProfile", { enumerable: true, get: function () { return HostProfiles_1.VSCodeProfile; } });
+Object.defineProperty(exports, "GenericProfile", { enumerable: true, get: function () { return HostProfiles_1.GenericProfile; } });
+Object.defineProperty(exports, "applyTheme", { enumerable: true, get: function () { return HostProfiles_1.applyTheme; } });
+/**
+ * Create a test context with a mock MCP host
+ */
+async function createMCPTestContext(config) {
+    const { MockMCPHost } = await Promise.resolve().then(() => __importStar(require('./core/MockMCPHost')));
+    const host = new MockMCPHost(config);
+    const interceptor = host.getInterceptor();
+    return {
+        host,
+        interceptor,
+        cleanup: async () => {
+            await host.cleanup();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BH,oDAYC;AApCD,kDAAiD;AAAxC,0GAAA,WAAW,OAAA;AACpB,oEAAmE;AAA1D,4HAAA,oBAAoB,OAAA;AAC7B,oDAA6G;AAApG,4GAAA,YAAY,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,8GAAA,cAAc,OAAA;AAAE,0GAAA,UAAU,OAAA;AAmB/E;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAC,MAA0B;IACnE,MAAM,EAAE,WAAW,EAAE,GAAG,wDAAa,oBAAoB,GAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IAE1C,OAAO;QACL,IAAI;QACJ,WAAW;QACX,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Types for MCP Apps Testing Framework
+ */
+/**
+ * JSON-RPC 2.0 message types
+ */
+export interface JSONRPCRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: unknown;
+}
+export interface JSONRPCResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: JSONRPCError;
+}
+export interface JSONRPCNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown;
+}
+export interface JSONRPCError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * Transport interceptor handler types
+ */
+export type MessageHandler = (message: JSONRPCRequest | JSONRPCResponse | JSONRPCNotification) => void | Promise<void>;
+export type RequestInterceptor = (request: JSONRPCRequest) => JSONRPCRequest | Promise<JSONRPCRequest>;
+export type ResponseInterceptor = (response: JSONRPCResponse) => JSONRPCResponse | Promise<JSONRPCResponse>;
+/**
+ * Transport interface for MCP communication
+ */
+export interface MCPTransport {
+    send?: (message: unknown) => void | Promise<void>;
+    close?: () => void | Promise<void>;
+}
+/**
+ * Mock MCP Host configuration
+ */
+export interface MockMCPHostConfig {
+    /**
+     * Whether to automatically respond to common MCP protocol messages
+     */
+    autoRespond?: boolean;
+    /**
+     * Custom transport implementation
+     */
+    transport?: MCPTransport;
+    /**
+     * Enable verbose logging
+     */
+    debug?: boolean;
+    /**
+     * Host profile to simulate (e.g., 'Claude', 'VSCode', 'Generic')
+     */
+    hostProfile?: string;
+}
+/**
+ * MCP capabilities that can be simulated
+ */
+export interface MCPCapabilities {
+    tools?: {
+        listChanged?: boolean;
+    };
+    resources?: {
+        subscribe?: boolean;
+        listChanged?: boolean;
+    };
+    prompts?: {
+        listChanged?: boolean;
+    };
+}
+/**
+ * Test context for MCP applications
+ */
+export interface MCPTestContext {
+    /**
+     * Mock host instance
+     */
+    host: import('../core/MockMCPHost').MockMCPHost;
+    /**
+     * Transport interceptor
+     */
+    interceptor: import('../core/TransportInterceptor').TransportInterceptor;
+    /**
+     * Cleanup function
+     */
+    cleanup: () => Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,GAAG,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAEvG,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5G;;GAEG;AACH,MAAM,WAAW,YAAY;IAE3B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,OAAO,qBAAqB,EAAE,WAAW,CAAC;IAEhD;;OAEG;IACH,WAAW,EAAE,OAAO,8BAA8B,EAAE,oBAAoB,CAAC;IAEzE;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types for MCP Apps Testing Framework
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "mcp-apps-testing",
+  "version": "0.1.0",
+  "description": "A professional framework for testing Model Context Protocol (MCP) UI applications with Playwright",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "playwright test",
+    "test:ui": "playwright test --ui",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "testing",
+    "playwright",
+    "ui-testing",
+    "json-rpc"
+  ],
+  "author": "Aviv Eldan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aviveldan/mcp-apps-testing.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aviveldan/mcp-apps-testing/issues"
+  },
+  "homepage": "https://github.com/aviveldan/mcp-apps-testing#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@playwright/test": "^1.40.0",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0"
+  },
+  "peerDependencies": {
+    "@playwright/test": "^1.40.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}