mcp-filter 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,74 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.5.0] - 2025-11-22
+
+### Added
+- **Multi-Transport Support**: Filter both local and remote MCP servers
+  - HTTP transport for remote MCP servers (Streamable HTTP)
+  - SSE transport for legacy servers (deprecated, backward compatibility)
+  - Stdio transport for local servers (existing functionality, unchanged)
+- `--upstream-url <url>` flag to connect to remote HTTP/SSE servers
+- `--transport <type>` flag to explicitly specify transport type (stdio/http/sse)
+- `--header <header>` flag to add custom HTTP headers (e.g., authentication)
+- `--help` flag to show usage information
+- Transport factory pattern for clean separation of transport logic
+- HTTP transport integration tests with context7 public endpoint
+- Comprehensive CLI tests for new transport options
+
+### Changed
+- **Breaking**: `FilterConfig` now uses `transportConfig` instead of `upstreamCommand`
+- Upgraded `@modelcontextprotocol/sdk` from 1.0.4 to 1.22.0
+- Updated peerDependencies to require SDK >=1.10.0 (for HTTP transport)
+- CLI now auto-detects transport type (HTTP for URLs, stdio for commands)
+- Updated documentation with HTTP/SSE usage examples
+- Reorganized codebase with new `src/types.ts` and `src/transport.ts` modules
+
+### Fixed
+- Increased timeout for integration tests using `npx` to prevent flaky failures
+- Updated architecture validation tests for new transport factory pattern
+
+## [0.4.0] - 2025-10-08
+
+### Fixed
+- Fixed connection failures caused by double-spawning upstream MCP server subprocess
+- Fixed "command not found" errors with `npx` by properly passing environment variables
+- Fixed stderr forwarding from upstream servers
+
+### Changed
+- Delegated subprocess management entirely to `StdioClientTransport` (breaking change in internal architecture)
+- Improved error forwarding by using `stderr: "inherit"` instead of `"pipe"`
+
+### Added
+- Comprehensive integration tests for subprocess management and real-world MCP server compatibility
+- Architecture validation tests to prevent regression of subprocess spawning anti-patterns
+- Debugging guide for common MCP communication issues in CLAUDE.md
+- ADR-003 documenting subprocess delegation pattern
+- Claude Code configuration with custom slash commands
+
+## [0.3.0] - 2025-01-XX
+
+### Added
+- Rsync-style pattern evaluation (first match wins)
+- Support for both `--include` and `--exclude` patterns
+
+### Changed
+- Pattern matching now evaluates in order with first-match-wins semantics
+
+## [0.2.0] - 2025-01-XX
+
+### Added
+- Comprehensive documentation updates
+- Testing infrastructure with Vitest
+
+## [0.1.0] - 2025-01-XX
+
+### Added
+- Initial release
+- Basic MCP proxy server with pattern-based filtering
+- Support for filtering tools, resources, and prompts
+- Glob pattern matching using minimatch

package/README.md

@@ -15,7 +15,7 @@ npx mcp-filter [options] -- <upstream-command>
 
 ## Usage
 
-### Basic Usage
+### Local MCP Servers (Stdio Transport)
 
 ```bash
 # Exclude mode: filter out specific tools
@@ -30,17 +30,49 @@ npx mcp-filter --exclude "browser_close" --include "browser_*" -- npx @playwrigh
 # Multiple patterns
 npx mcp-filter --exclude "playwright*" --exclude "unsafe_*" -- npx @playwright/mcp
 
-# Use with any MCP server
+# Use with any local MCP server
 npx mcp-filter --exclude "debug*" -- node my-mcp-server.js
 ```
 
+### Remote MCP Servers (HTTP/SSE Transport)
+
+```bash
+# Filter remote HTTP server (e.g., Notion, Stripe, Linear)
+npx mcp-filter --exclude "delete_*" --upstream-url https://mcp.notion.com/mcp
+
+# Filter with custom headers (authentication, etc.)
+npx mcp-filter --exclude "admin_*" \
+  --upstream-url https://api.example.com/mcp \
+  --header "Authorization: Bearer your-token-here"
+
+# SSE transport (deprecated, for legacy servers)
+npx mcp-filter --transport sse \
+  --upstream-url https://mcp.asana.com/sse \
+  --exclude "dangerous_*"
+
+# Complex filtering with remote servers
+npx mcp-filter \
+  --exclude "delete_*" \
+  --exclude "update_*" \
+  --include "read_*" \
+  --upstream-url https://mcp.example.com/mcp
+```
+
 ## Options
 
+### Filtering Options
 - `--exclude <pattern>` - Exclude tools/resources/prompts matching this pattern
 - `--include <pattern>` - Include ONLY tools/resources/prompts matching this pattern (whitelist mode)
-- `--` - Separates filter options from upstream server command
 
-Both options can be specified multiple times and combined together.
+### Transport Options
+- `--upstream-url <url>` - Connect to remote HTTP/SSE server (instead of local command)
+- `--transport <type>` - Transport type: `stdio`, `http`, `sse` (auto-detected if omitted)
+- `--header <header>` - Add HTTP header (format: `"Key: Value"`, HTTP/SSE only, can be repeated)
+- `--` - Separates options from local server command (stdio mode only)
+
+**Note**: `--upstream-url` and `--` are mutually exclusive. Use `--upstream-url` for remote servers, or `-- <command>` for local servers.
+
+All options can be specified multiple times and combined together.
 
 **Filtering style:** rsync-style evaluation where patterns are evaluated in the order specified, and first match wins.
 

package/dist/cli.d.ts

@@ -1,10 +1,3 @@
-export interface FilterPattern {
-    type: "include" | "exclude";
-    pattern: string;
-}
-export interface FilterConfig {
-    patterns: FilterPattern[];
-    upstreamCommand: string[];
-}
+import { FilterConfig } from "./types.js";
 export declare function parseArgs(args: string[]): FilterConfig;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAkDtD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAkKtD"}

package/dist/cli.js

@@ -1,6 +1,9 @@
 export function parseArgs(args) {
     const patterns = [];
     const upstreamCommand = [];
+    let upstreamUrl;
+    let explicitTransport;
+    const headers = {};
     let inUpstreamCommand = false;
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
@@ -28,14 +31,107 @@ export function parseArgs(args) {
             patterns.push({ type: "include", pattern });
             continue;
         }
+        if (arg === "--upstream-url") {
+            const url = args[++i];
+            if (!url) {
+                throw new Error("--upstream-url requires a URL argument");
+            }
+            upstreamUrl = url;
+            continue;
+        }
+        if (arg === "--transport") {
+            const transport = args[++i];
+            if (!transport) {
+                throw new Error("--transport requires a transport type argument");
+            }
+            if (transport !== "stdio" && transport !== "http" && transport !== "sse") {
+                throw new Error(`Invalid transport type: ${transport}. Must be one of: stdio, http, sse`);
+            }
+            explicitTransport = transport;
+            continue;
+        }
+        if (arg === "--header") {
+            const header = args[++i];
+            if (!header) {
+                throw new Error("--header requires a header value");
+            }
+            const colonIndex = header.indexOf(":");
+            if (colonIndex === -1) {
+                throw new Error(`Invalid header format: ${header}. Expected format: "Key: Value"`);
+            }
+            const key = header.slice(0, colonIndex).trim();
+            const value = header.slice(colonIndex + 1).trim();
+            headers[key] = value;
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            throw new Error("help");
+        }
         throw new Error(`Unknown argument: ${arg}`);
     }
-    if (upstreamCommand.length === 0) {
-        throw new Error("No upstream command specified. Use -- to separate filter args from upstream command");
+    // Validate: cannot specify both URL and command
+    if (upstreamUrl && upstreamCommand.length > 0) {
+        throw new Error("Cannot specify both --upstream-url and command after --. Use one or the other.");
+    }
+    // Build transport config
+    let transportConfig;
+    if (upstreamUrl) {
+        // URL-based transport (http or sse)
+        let transportType;
+        if (explicitTransport) {
+            if (explicitTransport === "stdio") {
+                throw new Error("--transport stdio cannot be used with --upstream-url. Use command after -- instead.");
+            }
+            transportType = explicitTransport;
+        }
+        else {
+            // Auto-detect: default to http
+            transportType = "http";
+        }
+        // Validate URL format
+        try {
+            new URL(upstreamUrl);
+        }
+        catch (e) {
+            throw new Error(`Invalid URL: ${upstreamUrl}`);
+        }
+        if (transportType === "http") {
+            transportConfig = {
+                type: "http",
+                url: upstreamUrl,
+                headers: Object.keys(headers).length > 0 ? headers : undefined,
+            };
+        }
+        else {
+            transportConfig = {
+                type: "sse",
+                url: upstreamUrl,
+                headers: Object.keys(headers).length > 0 ? headers : undefined,
+            };
+        }
+    }
+    else if (upstreamCommand.length > 0) {
+        // Command-based transport (stdio)
+        if (explicitTransport && explicitTransport !== "stdio") {
+            throw new Error(`--transport ${explicitTransport} requires --upstream-url. Use --transport stdio or omit --transport for command-based servers.`);
+        }
+        if (Object.keys(headers).length > 0) {
+            throw new Error("--header can only be used with --upstream-url");
+        }
+        transportConfig = {
+            type: "stdio",
+            command: upstreamCommand,
+            env: process.env,
+        };
+    }
+    else {
+        throw new Error("No upstream server specified. Use either:\n" +
+            "  --upstream-url <url> for HTTP/SSE servers\n" +
+            "  -- <command> for stdio servers");
     }
     return {
         patterns,
-        upstreamCommand,
+        transportConfig,
     };
 }
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,iBAAiB,EAAE,CAAC;YACtB,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,iBAAiB,GAAG,IAAI,CAAC;YACzB,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC3D,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC3D,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ;QACR,eAAe;KAChB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/filter.d.ts

@@ -1,4 +1,4 @@
-import { FilterPattern } from "./cli.js";
+import { FilterPattern } from "./types.js";
 export declare class Filter {
     private patterns;
     private hasIncludePatterns;

package/dist/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,qBAAa,MAAM;IAGL,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,kBAAkB,CAAU;gBAEhB,QAAQ,EAAE,aAAa,EAAE;IAI7C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAepC,UAAU,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;CAGxD"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,qBAAa,MAAM;IAGL,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,kBAAkB,CAAU;gBAEhB,QAAQ,EAAE,aAAa,EAAE;IAI7C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAepC,UAAU,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;CAGxD"}

package/dist/index.js

@@ -1,10 +1,9 @@
 #!/usr/bin/env node
-import { spawn } from "child_process";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 import { parseArgs } from "./cli.js";
 import { Filter } from "./filter.js";
 import { ProxyServer } from "./proxy.js";
+import { createClientTransport } from "./transport.js";
 async function main() {
     // Parse command line arguments
     const args = process.argv.slice(2);
@@ -13,12 +12,52 @@ async function main() {
         config = parseArgs(args);
     }
     catch (error) {
+        if (error.message === "help") {
+            console.log("Usage:");
+            console.log("  mcp-filter [options] -- <command> [args...]           # stdio transport");
+            console.log("  mcp-filter [options] --upstream-url <url>             # HTTP transport");
+            console.log("");
+            console.log("Options:");
+            console.log("  --exclude <pattern>     Exclude items matching pattern");
+            console.log("  --include <pattern>     Include items matching pattern");
+            console.log("  --upstream-url <url>    Connect to HTTP/SSE server (mutually exclusive with --)");
+            console.log("  --transport <type>      Transport type: stdio, http, sse (auto-detected if omitted)");
+            console.log("  --header <header>       Add HTTP header (format: 'Key: Value', HTTP/SSE only)");
+            console.log("  --help, -h              Show this help message");
+            console.log("");
+            console.log("Examples:");
+            console.log("  # Stdio transport (local servers)");
+            console.log('  mcp-filter --exclude "test*" -- npx tsx test-server.ts');
+            console.log("");
+            console.log("  # HTTP transport (remote servers)");
+            console.log('  mcp-filter --exclude "dangerous_*" --upstream-url https://mcp.notion.com/mcp');
+            console.log("");
+            console.log("  # SSE transport (deprecated, legacy servers)");
+            console.log('  mcp-filter --transport sse --upstream-url https://mcp.asana.com/sse');
+            process.exit(0);
+        }
         console.error(`Error: ${error.message}`);
-        console.error("Usage: mcp-filter [--exclude <pattern>]... [--include <pattern>]... -- <upstream-command> [args...]");
+        console.error("");
+        console.error("Usage:");
+        console.error("  mcp-filter [options] -- <command> [args...]           # stdio transport");
+        console.error("  mcp-filter [options] --upstream-url <url>             # HTTP transport");
+        console.error("");
+        console.error("Options:");
+        console.error("  --exclude <pattern>     Exclude items matching pattern");
+        console.error("  --include <pattern>     Include items matching pattern");
+        console.error("  --upstream-url <url>    Connect to HTTP/SSE server (mutually exclusive with --)");
+        console.error("  --transport <type>      Transport type: stdio, http, sse (auto-detected if omitted)");
+        console.error("  --header <header>       Add HTTP header (format: 'Key: Value', HTTP/SSE only)");
+        console.error("");
         console.error("Examples:");
-        console.error('  mcp-filter --exclude "playwright*" -- npx @playwright/mcp');
-        console.error('  mcp-filter --include "browser_navigate" --include "browser_screenshot" -- npx @playwright/mcp');
-        console.error('  mcp-filter --include "browser_*" --exclude "browser_close" -- npx @playwright/mcp');
+        console.error("  # Stdio transport (local servers)");
+        console.error('  mcp-filter --exclude "test*" -- npx tsx test-server.ts');
+        console.error("");
+        console.error("  # HTTP transport (remote servers)");
+        console.error('  mcp-filter --exclude "dangerous_*" --upstream-url https://mcp.notion.com/mcp');
+        console.error("");
+        console.error("  # SSE transport (deprecated, legacy servers)");
+        console.error('  mcp-filter --transport sse --upstream-url https://mcp.asana.com/sse');
         process.exit(1);
     }
     console.error(`Starting MCP filter with ${config.patterns.length} pattern(s)`);
@@ -28,21 +67,17 @@ async function main() {
     if (hasInclude && hasExclude) {
         console.error("Note: Using rsync-style filtering - patterns evaluated in order, first match wins.");
     }
-    // Spawn upstream server
-    const upstreamProcess = spawnUpstream(config.upstreamCommand);
+    console.error(`Transport: ${config.transportConfig.type}`);
     // Create filter
     const filter = new Filter(config.patterns);
     // Create proxy server
     const proxy = new ProxyServer({
         name: "mcp-filter",
-        version: "0.2.0",
+        version: "0.5.0",
     }, filter);
-    // Connect client to upstream server via subprocess stdio
-    const clientTransport = new StdioClientTransport({
-        command: config.upstreamCommand[0],
-        args: config.upstreamCommand.slice(1),
-        stderr: "pipe",
-    });
+    // Connect client to upstream server
+    // Transport factory handles creating the appropriate transport (stdio, http, sse)
+    const clientTransport = createClientTransport(config.transportConfig);
     await proxy.getClient().connect(clientTransport);
     console.error("Connected to upstream server");
     // Connect server to current process stdio (for the MCP client calling us)
@@ -52,31 +87,11 @@ async function main() {
     // Handle cleanup
     const cleanup = () => {
         console.error("Shutting down...");
-        upstreamProcess.kill();
         process.exit(0);
     };
     process.on("SIGINT", cleanup);
     process.on("SIGTERM", cleanup);
 }
-function spawnUpstream(command) {
-    const [cmd, ...args] = command;
-    const proc = spawn(cmd, args, {
-        stdio: ["pipe", "pipe", "pipe"],
-    });
-    // Forward stderr to our stderr
-    proc.stderr.on("data", (data) => {
-        process.stderr.write(data);
-    });
-    proc.on("error", (error) => {
-        console.error(`Failed to start upstream server: ${error.message}`);
-        process.exit(1);
-    });
-    proc.on("exit", (code) => {
-        console.error(`Upstream server exited with code ${code}`);
-        process.exit(code || 0);
-    });
-    return proc;
-}
 main().catch((error) => {
     console.error("Fatal error:", error);
     process.exit(1);

package/dist/index.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,11 @@
+import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { TransportConfig } from "./types.js";
+/**
+ * Creates a client transport based on the provided configuration.
+ *
+ * @param config - The transport configuration (stdio, http, or sse)
+ * @returns A configured Transport instance
+ * @throws Error if the configuration is invalid or transport creation fails
+ */
+export declare function createClientTransport(config: TransportConfig): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAI1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAsDxE"}

package/dist/transport.js

@@ -0,0 +1,57 @@
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+/**
+ * Creates a client transport based on the provided configuration.
+ *
+ * @param config - The transport configuration (stdio, http, or sse)
+ * @returns A configured Transport instance
+ * @throws Error if the configuration is invalid or transport creation fails
+ */
+export function createClientTransport(config) {
+    switch (config.type) {
+        case "stdio": {
+            if (config.command.length === 0) {
+                throw new Error("Stdio transport requires a command");
+            }
+            return new StdioClientTransport({
+                command: config.command[0],
+                args: config.command.slice(1),
+                env: config.env || process.env,
+                stderr: "inherit",
+            });
+        }
+        case "http": {
+            let url;
+            try {
+                url = new URL(config.url);
+            }
+            catch (e) {
+                throw new Error(`Invalid HTTP URL: ${config.url}`);
+            }
+            // Add custom headers to requestInit if provided
+            const requestInit = config.headers && Object.keys(config.headers).length > 0
+                ? { headers: config.headers }
+                : undefined;
+            return new StreamableHTTPClientTransport(url, { requestInit });
+        }
+        case "sse": {
+            console.warn("⚠️  WARNING: SSE transport is deprecated as of protocol version 2024-11-05. " +
+                "Consider using HTTP transport instead for better performance and compatibility.");
+            let url;
+            try {
+                url = new URL(config.url);
+            }
+            catch (e) {
+                throw new Error(`Invalid SSE URL: ${config.url}`);
+            }
+            return new SSEClientTransport(url);
+        }
+        default: {
+            // TypeScript exhaustiveness check
+            const _exhaustive = config;
+            throw new Error(`Unknown transport type: ${_exhaustive.type}`);
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAGnG;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,IAAI,oBAAoB,CAAC;gBAC9B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC1B,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7B,GAAG,EAAE,MAAM,CAAC,GAAG,IAAK,OAAO,CAAC,GAA8B;gBAC1D,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,GAAQ,CAAC;YACb,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YACrD,CAAC;YAED,gDAAgD;YAChD,MAAM,WAAW,GACf,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;gBACtD,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;gBAC7B,CAAC,CAAC,SAAS,CAAC;YAEhB,OAAO,IAAI,6BAA6B,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,OAAO,CAAC,IAAI,CACV,8EAA8E;gBAC5E,iFAAiF,CACpF,CAAC;YAEF,IAAI,GAAQ,CAAC;YACb,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YACpD,CAAC;YAED,OAAO,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACR,kCAAkC;YAClC,MAAM,WAAW,GAAU,MAAM,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,2BAA4B,WAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+export interface FilterPattern {
+    type: "include" | "exclude";
+    pattern: string;
+}
+export type TransportType = "stdio" | "http" | "sse";
+export interface StdioConfig {
+    type: "stdio";
+    command: string[];
+    env?: Record<string, string>;
+}
+export interface HttpConfig {
+    type: "http";
+    url: string;
+    headers?: Record<string, string>;
+}
+export interface SseConfig {
+    type: "sse";
+    url: string;
+    headers?: Record<string, string>;
+}
+export type TransportConfig = StdioConfig | HttpConfig | SseConfig;
+export interface FilterConfig {
+    patterns: FilterPattern[];
+    transportConfig: TransportConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe,EAAE,eAAe,CAAC;CAClC"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-filter",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "MCP server proxy to filter tools, resources, and prompts from upstream MCP servers",
   "type": "module",
   "bin": {
@@ -9,8 +9,17 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest --coverage",
+    "prepublishOnly": "pnpm test && pnpm run build"
+  },
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -31,10 +40,10 @@
     "minimatch": "10.0.1"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "1.0.0"
+    "@modelcontextprotocol/sdk": ">=1.10.0"
   },
   "devDependencies": {
-    "@modelcontextprotocol/sdk": "1.0.4",
+    "@modelcontextprotocol/sdk": "1.22.0",
     "@types/node": "22.10.5",
     "@vitest/coverage-v8": "2.1.8",
     "typescript": "5.7.3",
@@ -43,12 +52,5 @@
   },
   "engines": {
     "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest --watch",
-    "test:coverage": "vitest --coverage"
   }
-}
+}