io.github.chris-schra/mcp-funnel MCP Server

io.github.chris-schra/mcp-funnel

MCP proxy that aggregates multiple servers with tool filtering and customization

What is the io.github.chris-schra/mcp-funnel MCP server?

The mcp-funnel MCP server is a proxy that aggregates multiple MCP servers into a single interface, allowing you to filter and customize which tools are exposed. It enables centralized management of tool availability across multiple backend servers.

mcp-funnel acts as a middleware layer between your AI client and multiple MCP servers. It lets you combine tools from different servers, selectively expose or hide specific tools, and customize how they're presented—useful for managing complexity when working with many servers or controlling what capabilities are available in different contexts.

How to install io.github.chris-schra/mcp-funnel

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MCP_FUNNEL_CONFIG
Alternative way to specify config file path

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-funnel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-funnel",
        "-y",
        "config_path"
      ],
      "env": {
        "MCP_FUNNEL_CONFIG": "<YOUR_MCP_FUNNEL_CONFIG>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-funnel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-funnel",
        "-y",
        "config_path"
      ],
      "env": {
        "MCP_FUNNEL_CONFIG": "<YOUR_MCP_FUNNEL_CONFIG>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-funnel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-funnel",
        "-y",
        "config_path"
      ],
      "env": {
        "MCP_FUNNEL_CONFIG": "<YOUR_MCP_FUNNEL_CONFIG>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-funnel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-funnel",
        "-y",
        "config_path"
      ],
      "env": {
        "MCP_FUNNEL_CONFIG": "<YOUR_MCP_FUNNEL_CONFIG>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-funnel --env MCP_FUNNEL_CONFIG=<YOUR_MCP_FUNNEL_CONFIG> -- npx -y mcp-funnel -y config_path

Use cases

Aggregate tools from multiple MCP servers into a single unified interface
Filter and selectively expose tools based on your needs or security requirements
Customize tool names and descriptions for different use cases or users
Manage which tools are available in different client contexts
Reduce complexity by hiding unnecessary tools from specific workflows

io.github.chris-schra/mcp-funnel MCP server FAQ

What is mcp-funnel?

mcp-funnel is an MCP proxy server that sits between your AI client and multiple backend MCP servers, allowing you to aggregate, filter, and customize the tools exposed from those servers.

How do I install mcp-funnel?

Install via npm with: npm install mcp-funnel

Is mcp-funnel free?

Yes, mcp-funnel is open source and available on GitHub at https://github.com/chris-schra/mcp-funnel.

How do I configure mcp-funnel to work with multiple servers?

mcp-funnel acts as a proxy that connects to multiple backend MCP servers. Refer to the repository documentation for configuration details on specifying which servers to aggregate.

Can I filter which tools are exposed?

Yes, mcp-funnel's core feature is tool filtering and customization, allowing you to selectively expose or hide tools from the aggregated servers.

Active

Filesystem access MCP server from ByteDance's UI-TARS/Agent TARS ecosystem.

37k

TypeScript

Apache-2.0

View repository →