irm https://github.com/ericnunes30/mcp-gateway-proxy/releases/latest/download/install.ps1 | iex

node dist/cli.cjs setup

git clone https://github.com/ericnunes30/mcp-gateway-proxy.git
cd mcp-gateway-proxy
npm install
npm run build      # dist/cli.js (needs node_modules)
npm run dist:win   # release/ (standalone exe + zip + install.ps1)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    },
    "github": {
      "url": "https://api.github.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

# Standalone executable (installed by setup; not added to PATH)
& "$env:LOCALAPPDATA\mcp-tool-search\mcp-tool-search.exe" --version
& "$env:LOCALAPPDATA\mcp-tool-search\mcp-tool-search.exe" setup --print
& "$env:LOCALAPPDATA\mcp-tool-search\mcp-tool-search.exe" --mcp-config "$env:USERPROFILE\.config\mcp-tool-search\mcp.json"

# From source
node dist/cli.js --mcp-config ~/.config/mcp-tool-search/mcp.json

# From the zip bundle
node dist/cli.cjs --mcp-config ~/.config/mcp-tool-search/mcp.json

# --config also works as an alias
node dist/cli.js --config ~/.config/mcp-tool-search/mcp.json

# update: re-run the installer (replaces the exe, keeps the config)
irm https://github.com/ericnunes30/mcp-gateway-proxy/releases/latest/download/install.ps1 | iex

# uninstall (keeps ~/.config/mcp-tool-search)
& "$env:LOCALAPPDATA\mcp-tool-search\mcp-tool-search.exe" uninstall

# uninstall and remove the config directory too
& "$env:LOCALAPPDATA\mcp-tool-search\mcp-tool-search.exe" uninstall --purge

{
  "mcpServers": {
    "mcp-tool-search": {
      "type": "stdio",
      "command": "C:\\Users\\YOU\\AppData\\Local\\mcp-tool-search\\mcp-tool-search.exe",
      "args": ["--mcp-config", "C:\\Users\\YOU\\.config\\mcp-tool-search\\mcp.json"]
    }
  }
}

{
  "mcp": {
    "mcp-tool-search": {
      "type": "local",
      "command": [
        "C:\\Users\\YOU\\AppData\\Local\\mcp-tool-search\\mcp-tool-search.exe",
        "--mcp-config",
        "C:\\Users\\YOU\\.config\\mcp-tool-search\\mcp.json"
      ],
      "enabled": true
    }
  }
}

[mcp_servers.mcp-tool-search]
command = "C:/Users/YOU/AppData/Local/mcp-tool-search/mcp-tool-search.exe"
args = [ "--mcp-config", "C:/Users/YOU/.config/mcp-tool-search/mcp.json" ]

{
  "command": "node",
  "args": [
    "C:\\path\\to\\mcp-tool-search\\dist\\cli.cjs",
    "--mcp-config",
    "C:\\Users\\YOU\\.config\\mcp-tool-search\\mcp.json"
  ]
}

Client → mcp-tool-search (proxy) → N downstream servers

mcp({})                                              → Show server status
mcp({ server: "filesystem" })                        → List tools from server
mcp({ search: "file" })                              → Search tools
mcp({ describe: "read_file" })                        → Show tool details
mcp({ connect: "github" })                            → Connect to server
mcp({ tool: "read_file", args: '{"path":"/foo"}' })   → Call a tool
mcp({ action: "auth-start", server: "linear" })      → Start OAuth
mcp({ action: "auth-complete", server: "linear", args: '{"redirectUrl":"..."}' }) → Complete OAuth

mcp({}) →
MCP: 2/5 servers, 38 tools

✓ chrome-devtools (29 tools)
✓ pencil (9 tools)
○ stitch (not connected)
○ tavily (not connected)
○ computer-use (not connected)

mcp({ search: "screenshot" }) →
Found 3 tools matching "screenshot":

chrome_devtools_take_screenshot
  Take a screenshot of the page or element.
  Parameters: format, quality, uid, fullPage, filePath

pencil_get_screenshot
  Returns a screenshot of a node in a .pen file.
  Parameters: filePath, nodeId

┌──────────────────┐     stdio      ┌──────────────────┐
│  MCP Client      │◄──────────────►│  mcp-tool-search │
│  (Cursor, etc.)  │   JSON-RPC     │   (this server)  │
└──────────────────┘                └────────┬─────────┘
                                               │
                    ┌──────────────────────────┼──────────────────────────┐
                    │                          │                          │
              ┌─────┴─────┐            ┌──────┴──────┐           ┌──────┴──────┐
              │  stdio    │            │   HTTP/SSE  │           │ Streamable  │
              │  server   │            │   server    │           │   HTTP      │
              └───────────┘            └─────────────┘           └─────────────┘

npm install       # Install dependencies
npm run build     # Build with tsup → dist/cli.js
npm run typecheck # Type-check with tsc (no emit)
npm test          # Run vitest test suite (89 tests)
npm run dist:win  # Build release/ (standalone exe, zip, install.ps1, checksums)

src/
├── cli.ts                    # CLI entry point (server + setup/uninstall commands)
├── server.ts                 # MCP server setup + stdio transport
├── state.ts                  # Gateway state factory
├── version.ts                # Runtime version
├── install/
│   └── setup.ts              # Installer commands (setup/uninstall, client snippets)
├── config/
│   ├── types.ts              # Config types (McpConfig, ServerEntry, etc.)
│   ├── config.ts             # Config loader + merge logic
│   ├── imports.ts            # Config imports/expand logic
│   └── paths.ts              # Config path resolution
├── cache/
│   ├── metadata-cache.ts     # Metadata cache (hash-based invalidation)
│   └── tool-metadata.ts      # Tool metadata builder + search
├── auth/
│   ├── auth-store.ts         # Token storage (secure file permissions)
│   ├── oauth-provider.ts     # OAuth client provider
│   ├── oauth-flow.ts         # OAuth flow (start, complete, authenticate)
│   └── callback-server.ts    # OAuth callback HTTP server
├── mcp/
│   ├── server-manager.ts     # MCP server connection manager
│   ├── transport.ts          # Transport creation (stdio/HTTP/SSE/StreamableHTTP)
│   └── npx-resolver.ts       # npx package resolution (skip npm parent)
├── lifecycle/
│   ├── lifecycle.ts          # Lifecycle manager (lazy/eager/keep-alive)
│   └── lazy-connect.ts       # Lazy connect with 60s failure backoff
├── guard/
│   └── output-guard.ts       # Output truncation (50KiB / 2000 lines)
├── tools/
│   ├── proxy.ts              # Proxy tool definition + dispatch
│   ├── proxy-actions.ts      # Proxy action handlers (search/describe/call/etc.)
│   ├── direct-tools.ts       # Direct tool resolution + executor
│   └── tool-registrar.ts     # MCP content transformation
├── handlers/
│   ├── list-tools.ts         # ListToolsRequest handler
│   └── call-tool.ts          # CallToolRequest handler
└── utils/
    ├── abort.ts              # AbortSignal utilities
    ├── logger.ts             # stderr-only logger
    ├── env.ts                # Environment variable interpolation
    └── utils.ts              # General utilities (parallelLimit, etc.)