npm - mcp-filter - Versions diffs - 0.4.0 → 0.6.0 - Mend

mcp-filter 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -5,6 +5,50 @@ 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.6.0] - 2025-12-02
+### Added
+- **Consola Logging**: Modern CLI output with colors, icons, and semantic log levels
+  - `info` for startup information
+  - `success` for connection and ready states
+  - `error` for errors with actionable messages
+  - `fatal` for unrecoverable errors
+- **Argument Validation**: Detects common JSON configuration mistakes
+  - Catches combined flag+pattern in single string (e.g., `"--include pattern"`)
+  - Catches multiple flags in single string (e.g., `"--include pattern --"`)
+  - LLM-friendly error messages with WRONG/CORRECT examples
+### Changed
+- **README restructured** for better onboarding (490 → 189 lines)
+- Replaced all `console.*` calls with `consola` logger
+## [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

package/README.md CHANGED Viewed

@@ -3,374 +3,185 @@
 [![npm version](https://badge.fury.io/js/mcp-filter.svg)](https://www.npmjs.com/package/mcp-filter)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-MCP server proxy to filter tools, resources, and prompts from upstream MCP servers.
+Filter tools, resources, and prompts from MCP servers. Control what AI agents can access.
-## Installation
-```bash
-npm install -g mcp-filter
-# or use with npx
-npx mcp-filter [options] -- <upstream-command>
-```
-## Usage
+## Quick Start
-### Basic Usage
-```bash
-# Exclude mode: filter out specific tools
-npx mcp-filter --exclude "playwright*" -- npx @playwright/mcp
+Add to your MCP client config (Claude Desktop, Cursor, etc.):
-# Include mode: only allow specific tools
-npx mcp-filter --include "browser_navigate" --include "browser_screenshot" -- npx @playwright/mcp
-# Combination: include with exceptions (order matters!)
-npx mcp-filter --exclude "browser_close" --include "browser_*" -- npx @playwright/mcp
-# Multiple patterns
-npx mcp-filter --exclude "playwright*" --exclude "unsafe_*" -- npx @playwright/mcp
-# Use with any MCP server
-npx mcp-filter --exclude "debug*" -- node my-mcp-server.js
+```json
+{
+  "mcpServers": {
+    "playwright-safe": {
+      "command": "npx",
+      "args": [
+        "mcp-filter",
+        "--exclude", "browser_close",
+        "--exclude", "browser_evaluate",
+        "--include", "browser_*",
+        "--",
+        "npx", "@playwright/mcp@latest"
+      ]
+    }
+  }
+}
 ```
-## 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.
-**Filtering style:** rsync-style evaluation where patterns are evaluated in the order specified, and first match wins.
+This allows all `browser_*` tools **except** `browser_close` and `browser_evaluate`.
-## Filtering Modes
+## Why?
-### Exclude Mode (--exclude only)
+- **Security** - Block dangerous tools (eval, delete, admin operations)
+- **Control** - Whitelist only the tools your agent needs
+- **Works everywhere** - Proxy any MCP server (local or remote)
-Blocks specific items, allows everything else:
+## Installation
 ```bash
-# Block browser_close and browser_evaluate tools
-npx mcp-filter --exclude "browser_close" --exclude "browser_evaluate" -- npx @playwright/mcp
+npx mcp-filter [options] -- <server-command>
+# or install globally
+npm install -g mcp-filter
 ```
-### Include Mode (--include only)
+## How Patterns Work
-Allows ONLY specified items, blocks everything else:
+Use `--include` and `--exclude` with glob patterns:
 ```bash
-# Only allow safe, read-only browser tools
-npx mcp-filter --include "browser_navigate" --include "browser_screenshot" -- npx @playwright/mcp
+--include "browser_*"     # Allow all browser_* tools
+--exclude "browser_close" # Block browser_close
+--exclude "delete_*"      # Block all delete_* tools
 ```
-### Combination Mode (--include + --exclude)
-**Rsync-style filtering**: patterns evaluated in order, first match wins.
-⚠️ **Common mistake**: Putting `--include` before `--exclude` means the exclude never applies!
+**Order matters!** Patterns are evaluated in order, first match wins:
 ```bash
-# Example 1: Include first, then exclude (DOES NOT WORK AS EXPECTED!)
-npx mcp-filter --include "browser_*" --exclude "browser_close" -- npx @playwright/mcp
-# Result: All browser_* tools are INCLUDED (browser_* matched first)
-# browser_close is also included because it matches browser_* first
-# The --exclude "browser_close" is never evaluated!
-# Example 2: Exclude first, then include (CORRECT way to exclude exceptions!)
-npx mcp-filter --exclude "browser_close" --include "browser_*" -- npx @playwright/mcp
-# Result: browser_close is EXCLUDED (matched exclude first)
-# Other browser_* tools are included
-# Example 3: Multiple exclusions, then broad include (recommended pattern)
-npx mcp-filter --exclude "browser_close" --exclude "browser_evaluate" --include "browser_*" -- npx @playwright/mcp
-# Result: browser_close and browser_evaluate excluded (matched first)
-# All other browser_* tools included
-```
-**Key principle**: Order matters! The first pattern that matches determines if the item is included or excluded.
-## Pattern Examples
-Patterns use glob syntax (via minimatch):
-- `playwright*` - Match all items starting with "playwright"
-- `*_admin` - Match all items ending with "\_admin"
-- `test_*_debug` - Match items with pattern in middle
-- `exact_name` - Match exact name
-- `browser_*` - Match all browser-related tools
-- `*` - Match everything
-## Rsync-Style Filtering
+# CORRECT: exclude first, then include
+--exclude "browser_close" --include "browser_*"
+# Result: browser_close blocked, other browser_* allowed
-mcp-filter uses rsync-style pattern evaluation:
-1. **Order matters**: Patterns are evaluated in the order you specify them
-2. **First match wins**: Once a pattern matches, that determines the outcome
-3. **Default behavior**:
-   - If no patterns specified: allow everything (passthrough)
-   - If only `--include`: items not matching any include are excluded (whitelist mode)
-   - If only `--exclude`: items not matching any exclude are included
-   - If mixed: items not matching any pattern use whitelist mode if includes exist
-**Example workflow**:
-```bash
-# Put more specific patterns first
-npx mcp-filter \
-  --exclude "browser_close" \
-  --exclude "browser_evaluate" \
-  --include "browser_*" \
-  -- npx @playwright/mcp
-# This works because:
-# 1. browser_close matches --exclude "browser_close" first → excluded
-# 2. browser_evaluate matches --exclude "browser_evaluate" first → excluded
-# 3. browser_navigate matches --include "browser_*" → included
-# 4. other_tool doesn't match any pattern, but --include exists → excluded (whitelist mode)
+# WRONG: include first (exclude never matches!)
+--include "browser_*" --exclude "browser_close"
+# Result: ALL browser_* allowed (browser_* matches first)
 ```
-## Using with Claude Code
+## Configuration
-### Adding Filtered MCP Servers
+### JSON Config (Claude Desktop, Cursor, VS Code)
-Add filtered MCP servers to Claude Code using the `claude mcp add` command:
+Each argument must be a **separate string** in the array:
-```bash
-# Basic syntax
-claude mcp add <name> -- npx mcp-filter [filter-options] -- <upstream-command>
-# Example: Safe Playwright with read-only browser access
-claude mcp add playwright-safe -- \
-  npx mcp-filter \
-    --include "browser_navigate" \
-    --include "browser_screenshot" \
-    --include "browser_snapshot" \
-    -- npx @playwright/mcp@latest
-# Example: Block dangerous operations
-claude mcp add playwright-filtered -- \
-  npx mcp-filter \
-    --exclude "browser_close" \
-    --exclude "browser_evaluate" \
-    -- npx @playwright/mcp@latest
-# Example: Include category with exceptions (rsync-style)
-claude mcp add playwright -- \
-  npx mcp-filter \
-    --exclude "browser_close" \
-    --exclude "browser_evaluate" \
-    --include "browser_*" \
-    -- npx @playwright/mcp@latest
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "command": "npx",
+      "args": [
+        "mcp-filter",
+        "--exclude", "dangerous_*",
+        "--include", "safe_*",
+        "--",
+        "npx", "your-mcp-server"
+      ]
+    }
+  }
+}
 ```
-**Understanding the command structure:**
-- First `--` separates Claude's options from the mcp-filter command
-- Second `--` separates mcp-filter options from the upstream MCP server command
-### Scope Options
+**Config file locations:**
+- Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
+- Cursor: `.cursor/mcp.json` or `~/.cursor/mcp.json`
-Choose where to store the configuration:
+### CLI Usage
 ```bash
-# Local scope (default): Only you, only this project
-claude mcp add playwright-safe -- npx mcp-filter --include "browser_*" -- npx @playwright/mcp@latest
+# Local server (stdio)
+npx mcp-filter --exclude "admin_*" -- npx @playwright/mcp
-# User scope: Available across all your projects
-claude mcp add --scope user playwright-safe -- \
-  npx mcp-filter --include "browser_*" -- npx @playwright/mcp@latest
+# Remote server (HTTP)
+npx mcp-filter --exclude "delete_*" --upstream-url https://mcp.example.com/mcp
-# Project scope: Share with team via .mcp.json (checked into git)
-claude mcp add --scope project playwright-safe -- \
-  npx mcp-filter --include "browser_*" -- npx @playwright/mcp@latest
+# With authentication header
+npx mcp-filter --exclude "admin_*" \
+  --upstream-url https://api.example.com/mcp \
+  --header "Authorization: Bearer token"
 ```
-**Security Note**: Claude Code prompts for approval before using project-scoped servers from `.mcp.json` files. To reset approval choices, use `claude mcp reset-project-choices`.
-### Managing Filtered Servers
-```bash
-# List all configured servers
-claude mcp list
-# Get details for a specific server
-claude mcp get playwright-safe
+## Common Mistakes
-# Remove a server
-claude mcp remove playwright-safe
+### JSON args must be separate strings
-# Check server status in Claude Code
-/mcp
+**WRONG:**
+```json
+"args": ["mcp-filter", "--include browser_* --", "npx", "server"]
 ```
-### Practical Examples
-**Monitoring agent (read-only)**
-```bash
-claude mcp add browser-monitor -- \
-  npx mcp-filter \
-    --include "browser_navigate" \
-    --include "browser_snapshot" \
-    --include "browser_console_messages" \
-    --include "browser_network_requests" \
-    --include "browser_take_screenshot" \
-    -- npx @playwright/mcp@latest
+**CORRECT:**
+```json
+"args": ["mcp-filter", "--include", "browser_*", "--", "npx", "server"]
 ```
-**Testing agent (no destructive actions)**
+The shell splits arguments for you. JSON doesn't - you must split them manually.
-```bash
-claude mcp add browser-test -- \
-  npx mcp-filter \
-    --exclude "browser_close" \
-    --exclude "browser_tabs" \
-    --exclude "browser_evaluate" \
-    --include "browser_*" \
-    -- npx @playwright/mcp@latest
-```
+mcp-filter detects this and shows a helpful error:
-Note: Exclude patterns must come BEFORE the include pattern to match first.
+```
+Malformed argument: "--include browser_* --"
-**Production debugging (safe operations only)**
+WRONG:
+  "args": ["--include browser_* --", ...]
-```bash
-# Add as user-scoped for use across projects
-claude mcp add --scope user prod-debugger -- \
-  npx mcp-filter \
-    --exclude "browser_click" \
-    --exclude "browser_type" \
-    --exclude "browser_evaluate" \
-    --exclude "browser_fill_form" \
-    --include "browser_*" \
-    -- npx @playwright/mcp@latest
+CORRECT:
+  "args": ["--include", "browser_*", "--", ...]
 ```
-### Updating Server Configuration
+### Pattern order matters
-To update filter rules, remove and re-add the server:
+Put `--exclude` patterns **before** `--include` to create exceptions:
 ```bash
-# Remove existing configuration
-claude mcp remove playwright-safe
-# Add with new filter rules
-claude mcp add playwright-safe -- \
-  npx mcp-filter \
-    --include "browser_navigate" \
-    --include "browser_screenshot" \
-    -- npx @playwright/mcp@latest
+# Block browser_close, allow other browser_* tools
+--exclude "browser_close" --include "browser_*"
 ```
-## Using with Cursor IDE
+## Options Reference
-Add to your `.cursor/mcp.json` or `~/.cursor/mcp.json`:
+| Option | Description |
+|--------|-------------|
+| `--include <pattern>` | Include items matching pattern (whitelist) |
+| `--exclude <pattern>` | Exclude items matching pattern (blocklist) |
+| `--upstream-url <url>` | Connect to remote HTTP/SSE server |
+| `--transport <type>` | Transport: `stdio`, `http`, `sse` (auto-detected) |
+| `--header <header>` | HTTP header (format: `"Key: Value"`) |
+| `--help` | Show help |
-### Example 1: Exclude specific dangerous tools
+Options can be repeated. Patterns use glob syntax via [minimatch](https://github.com/isaacs/minimatch).
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "mcp-filter",
-        "--exclude",
-        "browser_close",
-        "--exclude",
-        "browser_evaluate",
-        "--",
-        "npx",
-        "@playwright/mcp@latest"
-      ]
-    }
-  }
-}
-```
-### Example 2: Include safe tools only
+## How It Works
-```json
-{
-  "mcpServers": {
-    "playwright-safe": {
-      "command": "npx",
-      "args": [
-        "mcp-filter",
-        "--include",
-        "browser_navigate",
-        "--include",
-        "browser_screenshot",
-        "--include",
-        "browser_snapshot",
-        "--",
-        "npx",
-        "@playwright/mcp@latest"
-      ]
-    }
-  }
-}
 ```
-### Example 3: Include category with exceptions (rsync-style)
-```json
-{
-  "mcpServers": {
-    "playwright-filtered": {
-      "command": "npx",
-      "args": [
-        "mcp-filter",
-        "--exclude",
-        "browser_close",
-        "--exclude",
-        "browser_evaluate",
-        "--include",
-        "browser_*",
-        "--",
-        "npx",
-        "@playwright/mcp@latest"
-      ]
-    }
-  }
-}
+MCP Client → mcp-filter → Upstream MCP Server
+                ↓
+         Filters tools/list
+         Blocks excluded calls
 ```
-Note: Exclude patterns come first to match before the broader include pattern.
-After adding the configuration, restart Cursor completely to apply the changes.
-## How It Works
-mcp-filter acts as a proxy between an MCP client and an upstream MCP server:
-1. Spawns the upstream MCP server as a subprocess
-2. Connects to it as an MCP client
-3. Exposes a filtered MCP server interface
-4. Filters `tools/list`, `resources/list`, and `prompts/list` responses
-5. Blocks calls to filtered items with error responses
+1. Proxies requests between your MCP client and upstream server
+2. Filters `tools/list`, `resources/list`, `prompts/list` responses
+3. Blocks calls to filtered items with error responses
 ## Development
 ```bash
-# Install dependencies
 pnpm install
-# Build
 pnpm run build
-# Run tests
 pnpm test
-# Test locally
-./dist/index.js --exclude "playwright*" -- npx tsx test-server.ts
 ```
 ## Links
 - [npm package](https://www.npmjs.com/package/mcp-filter)
-- [GitHub repository](https://github.com/baranovxyz/mcp-filter)
+- [GitHub](https://github.com/baranovxyz/mcp-filter)
 ## License

package/dist/cli.d.ts CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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~~"}
1	+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAGb,MAAM,YAAY,CAAC;AAwCpB,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAoKtD"}

package/dist/cli.js CHANGED Viewed

@@ -1,6 +1,43 @@
+/**
+ * Validates arguments for common JSON configuration mistakes.
+ * In JSON configs, each argument must be a separate array element.
+ * This catches cases like ["--include pattern"] instead of ["--include", "pattern"].
+ */
+function validateArgs(args) {
+    for (const arg of args) {
+        // Detect combined flag+value: "--include pattern" or "--exclude pattern"
+        if (/^--(include|exclude)\s+/.test(arg)) {
+            const parts = arg.split(/\s+/);
+            const flag = parts[0];
+            const pattern = parts.slice(1).join(" ");
+            throw new Error(`Malformed argument: "${arg}"\n\n` +
+                `In JSON config, each argument must be a separate string.\n\n` +
+                `WRONG:\n` +
+                `  "args": ["${arg}", ...]\n\n` +
+                `CORRECT:\n` +
+                `  "args": ["${flag}", "${pattern}", ...]\n\n` +
+                `Split the argument into separate array elements.`);
+        }
+        // Detect multiple flags in one string: "--include pattern --" or "--exclude foo --include bar"
+        if (arg.startsWith("--") && / --/.test(arg)) {
+            throw new Error(`Malformed argument: "${arg}"\n\n` +
+                `Multiple flags found in single argument. In JSON config, each must be separate.\n\n` +
+                `WRONG:\n` +
+                `  "args": ["${arg}", ...]\n\n` +
+                `CORRECT:\n` +
+                `  "args": ["--include", "pattern", "--", ...]\n\n` +
+                `Split into separate array elements.`);
+        }
+    }
+}
 export function parseArgs(args) {
+    // Validate for common JSON config mistakes before parsing
+    validateArgs(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 +65,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 CHANGED Viewed

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

package/dist/filter.d.ts CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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"}
1	+ {"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 CHANGED Viewed

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 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 { logger } from "./logger.js";
 import { ProxyServer } from "./proxy.js";
+import { createClientTransport } from "./transport.js";
 async function main() {
     // Parse command line arguments
     const args = process.argv.slice(2);
@@ -12,52 +13,69 @@ async function main() {
         config = parseArgs(args);
     }
     catch (error) {
-        console.error(`Error: ${error.message}`);
-        console.error("Usage: mcp-filter [--exclude <pattern>]... [--include <pattern>]... -- <upstream-command> [args...]");
-        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');
+        const helpText = `Usage:
+  mcp-filter [options] -- <command> [args...]           # stdio transport
+  mcp-filter [options] --upstream-url <url>             # HTTP transport
+Options:
+  --exclude <pattern>     Exclude items matching pattern
+  --include <pattern>     Include items matching pattern
+  --upstream-url <url>    Connect to HTTP/SSE server (mutually exclusive with --)
+  --transport <type>      Transport type: stdio, http, sse (auto-detected if omitted)
+  --header <header>       Add HTTP header (format: 'Key: Value', HTTP/SSE only)
+  --help, -h              Show this help message
+Examples:
+  # Stdio transport (local servers)
+  mcp-filter --exclude "test*" -- npx tsx test-server.ts
+  # HTTP transport (remote servers)
+  mcp-filter --exclude "dangerous_*" --upstream-url https://mcp.notion.com/mcp
+  # SSE transport (deprecated, legacy servers)
+  mcp-filter --transport sse --upstream-url https://mcp.asana.com/sse`;
+        if (error.message === "help") {
+            logger.log(helpText);
+            process.exit(0);
+        }
+        logger.error(error.message);
+        logger.log(helpText);
         process.exit(1);
     }
-    console.error(`Starting MCP filter with ${config.patterns.length} pattern(s)`);
-    config.patterns.forEach((p) => console.error(`  ${p.type === "include" ? "Include" : "Exclude"}: ${p.pattern}`));
+    logger.info(`Starting MCP filter with ${config.patterns.length} pattern(s)`);
+    config.patterns.forEach((p) => logger.info(`  ${p.type === "include" ? "Include" : "Exclude"}: ${p.pattern}`));
     const hasInclude = config.patterns.some((p) => p.type === "include");
     const hasExclude = config.patterns.some((p) => p.type === "exclude");
     if (hasInclude && hasExclude) {
-        console.error("Note: Using rsync-style filtering - patterns evaluated in order, first match wins.");
+        logger.info("Note: Using rsync-style filtering - patterns evaluated in order, first match wins.");
     }
+    logger.info(`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.6.0",
     }, filter);
-    // Connect client to upstream server via subprocess stdio
-    // StdioClientTransport spawns and manages the subprocess
-    const clientTransport = new StdioClientTransport({
-        command: config.upstreamCommand[0],
-        args: config.upstreamCommand.slice(1),
-        env: process.env, // Pass current environment
-        stderr: "inherit", // Forward upstream stderr to our stderr
-    });
+    // 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");
+    logger.success("Connected to upstream server");
     // Connect server to current process stdio (for the MCP client calling us)
     const serverTransport = new StdioServerTransport();
     await proxy.getServer().connect(serverTransport);
-    console.error("MCP filter proxy ready");
+    logger.success("MCP filter proxy ready");
     // Handle cleanup
     const cleanup = () => {
-        console.error("Shutting down...");
+        logger.info("Shutting down...");
         process.exit(0);
     };
     process.on("SIGINT", cleanup);
     process.on("SIGTERM", cleanup);
 }
 main().catch((error) => {
-    console.error("Fatal error:", error);
+    logger.fatal(error);
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,~~oBAAoB~~,EAAE,MAAM,~~2CAA2C~~,CAAC;~~AACjF~~,OAAO,EAAE,~~SAAS~~,EAAE,MAAM,~~UAAU~~,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;~~AAEzC~~,KAAK,UAAU,IAAI;IACjB,+BAA+B;IAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,~~OAAO~~,~~CAAC~~,~~KAAK~~,CAAC,~~UAAW~~,KAAe,CAAC,OAAO,EAAE,CAAC~~,CAAC~~;~~QACpD~~,~~OAAO~~,CAAC,~~KAAK~~,~~CACX~~,~~qGAAqG~~,~~CACtG~~,CAAC;~~QACF~~,OAAO,CAAC,~~KAAK~~,CAAC,~~WAAW~~,CAAC,CAAC;~~QAC3B~~,~~OAAO~~,CAAC,KAAK,~~CACX~~,~~6DAA6D~~,~~CAC9D,~~CAAC~~;QACF~~,OAAO,CAAC,~~KAAK,CACX,iGAAiG,CAClG,~~CAAC;~~QACF~~,~~OAAO~~,CAAC,~~KAAK~~,~~CACX~~,~~qFAAqF~~,~~CACtF~~,CAAC;~~QACF~~,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,~~OAAO~~,CAAC,~~KAAK~~,~~CACX~~,4BAA4B,MAAM,CAAC,QAAQ,CAAC,MAAM,aAAa,~~CAChE~~,CAAC;~~IACF~~,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5B,~~OAAO~~,CAAC,~~KAAK~~,~~CACX~~,KAAK,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE,~~CAClE~~,~~CACF~~,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAErE,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;QAC7B,~~OAAO~~,CAAC,~~KAAK~~,~~CACX~~,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE3C,sBAAsB;IACtB,MAAM,KAAK,GAAG,IAAI,WAAW,CAC3B;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,EACD,MAAM,CACP,CAAC;IAEF,~~yDAAyD~~;~~IACzD~~,~~yDAAyD~~;~~IACzD~~,MAAM,eAAe,GAAG,~~IAAI~~,~~oBAAoB,~~CAAC~~;QAC/C~~,~~OAAO,EAAE,~~MAAM,CAAC,eAAe,CAAC,CAAC~~,CAAC~~;~~QAClC~~,~~IAAI,EAAE,~~MAAM,~~CAAC,eAAe,CAAC,~~KAAK,CAAC,~~CAAC,CAAC;QACrC,GAAG,EAAE,OAAO,CAAC,GAA6B,EAAE,2BAA2B;QACvE,MAAM,EAAE,~~SAAS,EAAE,~~wCAAwC;KAC5D,~~CAAC,~~CAAC;IAEH,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC,~~OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,~~OAAO~~,CAAC,~~KAAK~~,CAAC,8BAA8B,CAAC,CAAC;~~IAE9C~~,0EAA0E;IAC1E,MAAM,eAAe,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACnD,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,~~OAAO~~,CAAC,~~KAAK~~,CAAC,wBAAwB,CAAC,CAAC;~~IAExC~~,iBAAiB;IACjB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,~~OAAO~~,CAAC,~~KAAK~~,CAAC,kBAAkB,CAAC,CAAC;~~QAClC~~,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,~~OAAO~~,CAAC,KAAK,CAAC,~~cAAc,EAAE,~~KAAK,CAAC,CAAC;~~IACrC~~,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/logger.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export declare const logger: import("consola").ConsolaInstance;
2	+ //# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,mCAEjB,CAAC"}

package/dist/logger.js ADDED Viewed

@@ -0,0 +1,6 @@
+import { createConsola } from "consola";
+// Create logger that outputs to stderr to not interfere with MCP JSON-RPC on stdout
+export const logger = createConsola({
+    stderr: process.stderr,
+});
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,oFAAoF;AACpF,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC,MAAM;CACvB,CAAC,CAAC"}

package/dist/transport.d.ts ADDED Viewed

@@ -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 ADDED Viewed

	@@ -0,0 +1 @@
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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

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

package/dist/types.js.map ADDED Viewed

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

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "mcp-filter",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "MCP server proxy to filter tools, resources, and prompts from upstream MCP servers",
   "type": "module",
   "bin": {
@@ -12,6 +12,14 @@
     "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",
@@ -29,13 +37,14 @@
     "url": "https://github.com/baranovxyz/mcp-filter/issues"
   },
   "dependencies": {
+    "consola": "3.4.2",
     "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",
@@ -44,12 +53,5 @@
   },
   "engines": {
     "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest --watch",
-    "test:coverage": "vitest --coverage"
   }
-}
+}