@sarthakpranesh/mcp-lazy-proxy 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sarthak Pranesh
+
+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,182 @@
+# MCP Lazy Proxy
+
+Lazy MCP proxy for LLM clients. Instead of injecting every backend MCP server's tool schemas into the model context, it exposes just two meta-tools — `get_mcp_tools` and `call_mcp_tool` — that load and invoke backend servers on demand. The model sees a tiny, stable tool surface. Backends are connected lazily, their tool lists are cached, and idle connections are closed automatically.
+
+## Why
+
+I run local models on a small mini PC — a KAMRUI Hyper H1 with an AMD Ryzen 7 6800H, 32 GB RAM, and 16 GB of shared UMA vRAM for the iGPU. It works surprisingly well, but context bloat is the one thing that keeps tripping me up the moment I plug in the MCPs I actually use every day.
+
+With 9 MCP servers wired up (GitHub, Sentry, n8n, etc), a plain "hello" was eating roughly 41k of context in opencode — and I only have 64k to play with on local models. A model I really like, Qwen3.5-35B-A3B-UD-IQ3_S, would spend a solid minute chewing through the prompt before it got to do anything useful.
+
+So I wrote this in a single night session. Now my "hello" costs just under 10k of context :>
+
+## What makes this different
+
+Other lazy MCP proxies are all-or-nothing: they either keep every backend lazy or inject everything eagerly. This proxy is the only one that lets you pick a middle ground.
+
+- **Favorites** — mark a handful of backends you reach for every session as `favorite` and their schemas are injected up front (no discovery round-trip), while the rest stay lazy. A real context-vs-latency knob, not a binary choice.
+- **Live discovery, no build step** — tools are fetched on demand at runtime. No pre-generated tool hierarchy to keep in sync.
+- **Filtered discovery** — `get_mcp_tools` takes `query` and `limit`, so the model pulls only the relevant subset of a backend's schemas.
+- **Connection lifecycle** — backends connect lazily and auto-close after 5 minutes idle, so resources aren't held for the whole session.
+- **Remote + local** — one proxy handles both HTTP/Streamable and stdio backends.
+- **Measured, not guessed** — `bench.mjs` quantifies the lazy/favorites/all-eager tradeoff with real numbers.
+
+## Features
+
+- Only two tool schemas injected into the model context, no matter how many backends you configure
+- `get_mcp_tools` discovers a backend's tools (with optional name/description filter and result limit)
+- `call_mcp_tool` forwards a tool invocation to any backend
+- Backends connect lazily on first use and close after 5 minutes idle
+- Supports both remote (HTTP/Streamable) and local (stdio subprocess) MCP servers
+- Per-backend `instruction` lets you tell the model what each MCP is for
+- Advertises the backend catalog via MCP `instructions`, so the model knows what's available up front
+- Mark a backend as a `favorite` to inject its schemas eagerly while the rest stay lazy
+
+## Quick start
+
+**Requirements:** Node.js 18+. Install and build:
+
+```bash
+npm install
+npm run build
+```
+
+Create a config file pointing at your MCP servers. See [Configuration](#configuration) for the full shape.
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "url": "https://api.githubcopilot.com/mcp/",
+      "headers": { "Authorization": "Bearer <TOKEN>" },
+      "instruction": "GitHub: issues, pull requests, code search. Use for anything repo-related."
+    },
+    "local-tool": {
+      "type": "local",
+      "command": "npx",
+      "args": ["-y", "some-mcp-server"],
+      "instruction": "A local stdio MCP server."
+    }
+  }
+}
+```
+
+Point your MCP client at it as a stdio server. For example, in an MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "lazy-proxy": {
+      "command": "npx",
+      "args": ["-y", "@sarthakpranesh/mcp-lazy-proxy", "--config", "/path/to/mcp.json"]
+    }
+  }
+}
+```
+
+## Configuration
+
+The proxy takes a single JSON config file via `--config <path>`. It must have an `mcpServers` object; each entry is a backend with either a `url` (remote) or a `command` (local).
+
+### Backend reference
+
+| Field         | Required | Description                                                                 |
+| ------------- | -------- | --------------------------------------------------------------------------- |
+| `url`         | Remote   | HTTP(S) endpoint of a remote MCP server (Streamable HTTP).                  |
+| `headers`     | No       | Extra headers for the remote server, e.g. `Authorization`.                  |
+| `command`     | Local    | Executable to spawn for a local stdio MCP server.                           |
+| `args`        | No       | Arguments passed to the local command.                                      |
+| `env`         | No       | Extra environment variables for the local command.                           |
+| `instruction` | No       | Human/LLM-facing description of what this MCP is for. Shown in the catalog and returned by `get_mcp_tools`. Falls back to the mcp server's own instructions when omitted. |
+| `favorite`    | No       | `true` to inject this backend's tool schemas eagerly into the model context instead of keeping it lazy. See [Favorites](#favorites). |
+
+## Using the proxy
+
+The proxy advertises two meta-tools to the model.
+
+### `get_mcp_tools`
+
+Discover what a backend can do before calling it. Returns the backend's instruction plus a filtered list of tool names, descriptions, and input schemas.
+
+| Argument | Type   | Description                                                       |
+| -------- | ------ | ----------------------------------------------------------------- |
+| `mcp`    | string | Name of the MCP backend from the proxy config.                    |
+| `query`  | string | Optional substring filter on tool name/description.               |
+| `limit`  | number | Optional cap on results (default 50).                             |
+
+### `call_mcp_tool`
+
+Invoke a tool on a backend. Use the tool name and arguments returned by `get_mcp_tools`.
+
+| Argument    | Type   | Description                                        |
+| ----------- | ------ | -------------------------------------------------- |
+| `mcp`       | string | Name of the MCP backend from the proxy config.     |
+| `tool`      | string | Tool name as returned by `get_mcp_tools`.          |
+| `arguments` | object | Arguments per the tool's input schema.             |
+
+### Workflow
+
+1. The model reads the advertised catalog (backend names + instructions).
+2. It calls `get_mcp_tools` to load a backend's schemas.
+3. It calls `call_mcp_tool` to run a tool, passing the discovered arguments.
+
+## Favorites
+
+All-lazy guarantees the smallest context footprint, but every call first pays a `get_mcp_tools` round-trip to bring the backend's schemas into context. Mark a backend as a `favorite` and its schemas are injected up front instead — so the model can call its tools directly, no discovery step required. The rest stay lazy.
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "url": "https://api.githubcopilot.com/mcp/",
+      "headers": { "Authorization": "Bearer <TOKEN>" },
+      "favorite": true,
+      "instruction": "GitHub: issues, pull requests, code search."
+    }
+  }
+}
+```
+
+Pick a handful you reach for every session; leave long-tail backends lazy.
+
+## Benchmark
+
+`bench.mjs` compares three modes against a backend of your choice: all-lazy, favorites (that one backend eager), and all-eager. It measures injected schemas, approximated context tokens, and end-to-end latency of one real tool call ( skips the impact added from extra inference required from get_mcp_tools to call_mcp_tool, but added manually ).
+
+```bash
+npm run build
+node bench.mjs            # defaults to the github backend
+BENCH_MCP="promptify" BENCH_TOOL="get_prompts" node bench.mjs
+```
+
+Sample output for `BENCH_MCP=github` and `BENCH_TOOL=get_me`:
+
+| mode      | injected tools | context (approx tokens) | end-to-end call | impact from added inference |
+| --------- | -------------- | ----------------------- | --------------- | --------------------------- |
+| lazy      | 2              | 167                     | 3.69s           | high                        |
+| favorites | 46             | 9845                    | 437ms           | non fav - high, fav - none  |
+| all       | 118            | 31820                   | 417ms           | none                        |
+
+Impact on context: github mcp as favorite adds 9678 tokens vs all-lazy this is highly dependent on which mcp(s) you add to favorites; all-eager adds 31820 tokens for all my 9 MCPs vs all-lazy.
+
+latency: favorites first-call 3.25s faster than all-lazy, without the time taken in inference from get_mcp_tools to call_mcp_tool. For cloud models this will be fast, for local models this might add a second.
+
+The numbers are approximate — token count is estimated at 4 chars/token and excludes the model's own prompt overhead — but the shape is consistent: all-lazy is the cheapest, all-eager the fastest, favorites sits somewhere in the middle.
+
+## Troubleshooting
+
+| Problem                          | What to try                                                                                          |
+| -------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| `unknown mcp server "X"`         | The name must match a key in `mcpServers` exactly.                                                   |
+| `must have a "url" or "command"` | Every backend needs one of the two; check the config for typos.                                      |
+| Backend not reachable            | For remote servers, confirm the URL and `Authorization` header are correct.                          |
+| Model calls a tool that doesn't exist | Run `get_mcp_tools` first to see the real tool names and schemas before calling.                |
+| Backend keeps reconnecting       | Connections close after 5 minutes idle by design; that's expected.                                   |
+
+## Contributing
+
+Want to change code, fix bugs, or improve docs? The project is a small TypeScript MCP server. `src/index.ts` wires up the meta-tools and eager favorites, `src/backend.ts` manages lazy connections and caching, and `src/config.ts` parses the config. Run `npm run typecheck` to typecheck, `node smoke.mjs` for a smoke test, and `node bench.mjs` for the benchmark against your local MCP config.
+
+<p align="left">
+  With love from India 🇮🇳
+</p>

package/dist/backend.d.ts

@@ -0,0 +1,40 @@
+import type { BackendConfig } from "./config.js";
+export interface BackendTool {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface BackendHandle {
+    instruction?: string;
+    listTools(query?: string, limit?: number): Promise<BackendTool[]>;
+    callTool(tool: string, args: Record<string, unknown>): Promise<unknown>;
+    close(): Promise<void>;
+}
+export interface BackendSummary {
+    name: string;
+    instruction?: string;
+}
+export declare class BackendManager {
+    private readonly configs;
+    private readonly clients;
+    private readonly tools;
+    private readonly idleTimers;
+    constructor(configs: Record<string, BackendConfig>);
+    list(): BackendSummary[];
+    favorites(): string[];
+    loadFavorites(): Promise<{
+        tools: BackendTool[];
+        owner: Map<string, {
+            backend: string;
+            realToolName: string;
+        }>;
+    }>;
+    get(name: string): Promise<BackendHandle>;
+    private connect;
+    private buildTransport;
+    private listTools;
+    private callTool;
+    private resetIdleTimer;
+    private close;
+    closeAll(): Promise<void>;
+}

package/dist/backend.js

@@ -0,0 +1,171 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import packageJson from "../package.json" with { type: "json" };
+// the idle timeout for a backend connection
+const IDLE_TIMEOUT_MS = 5 * 60_000;
+// lazily connects to backends, caches their tool lists, and closes on idle.
+export class BackendManager {
+    configs;
+    clients = new Map();
+    tools = new Map();
+    idleTimers = new Map();
+    constructor(configs) {
+        this.configs = configs;
+    }
+    // return the catalog of configured backends (name + instruction).
+    list() {
+        return Object.entries(this.configs).map(([name, cfg]) => ({
+            name,
+            instruction: cfg.instruction,
+        }));
+    }
+    // return the names of backends flagged as favorites (eagerly loaded).
+    favorites() {
+        return Object.entries(this.configs)
+            .filter(([, cfg]) => cfg.favorite)
+            .map(([name]) => name);
+    }
+    // eagerly connect to the favorite backends and collect their tool schemas,
+    // along with a map of each tool name to its owning backend.
+    // a backend that fails to load is skipped so one bad favorite can't crash the proxy.
+    async loadFavorites() {
+        const names = this.favorites();
+        const sets = await Promise.all(names.map(async (n) => {
+            try {
+                return { name: n, tools: await this.listTools(n) };
+            }
+            catch {
+                return { name: n, tools: [] };
+            }
+        }));
+        const tools = [];
+        const owner = new Map();
+        for (const s of sets) {
+            for (const t of s.tools) {
+                // tool names are prefixed with the backend name so same-named tools from
+                // different backends (e.g. promptify vs promptify_personal) don't collide.
+                // has two underscores to separate the backend name from the tool name
+                const prefixed = `${s.name}__${t.name}`;
+                tools.push({ ...t, name: prefixed });
+                if (!owner.has(prefixed))
+                    owner.set(prefixed, {
+                        backend: s.name,
+                        realToolName: t.name,
+                    });
+            }
+        }
+        return { tools, owner };
+    }
+    // get a handle to a backend, connecting lazily and resetting its idle timer.
+    async get(name) {
+        const cfg = this.configs[name];
+        if (!cfg) {
+            throw new Error(`unknown mcp server "${name}"`);
+        }
+        const client = await this.connect(name, cfg);
+        this.resetIdleTimer(name);
+        return {
+            instruction: cfg.instruction ?? client.getInstructions(),
+            listTools: (query, limit) => this.listTools(name, query, limit),
+            callTool: (tool, args) => this.callTool(name, tool, args),
+            close: () => this.close(name),
+        };
+    }
+    // connect to a backend if not already connected, reusing the cached client.
+    async connect(name, cfg) {
+        const existing = this.clients.get(name);
+        if (existing)
+            return existing;
+        const transport = this.buildTransport(cfg);
+        // create a new client with the package name and version
+        const client = new Client({ name: packageJson.name, version: packageJson.version });
+        await client.connect(transport);
+        // cache the client
+        this.clients.set(name, client);
+        return client;
+    }
+    // build the SDK transport for a backend (HTTP for url, stdio for command).
+    buildTransport(cfg) {
+        // build the transport for a remote backend
+        if ("url" in cfg && cfg.url) {
+            return new StreamableHTTPClientTransport(new URL(cfg.url), {
+                requestInit: cfg.headers ? { headers: cfg.headers } : undefined,
+            });
+        }
+        // build the transport for a local backend
+        const local = cfg;
+        return new StdioClientTransport({
+            command: local.command,
+            args: local.args ?? [],
+            env: local.env,
+        });
+    }
+    // list a backend's tools, caching them and applying optional query/limit filters.
+    async listTools(name, query, limit) {
+        const client = await this.connect(name, this.configs[name]);
+        // get the cached tools for the backend
+        let tools = this.tools.get(name);
+        if (!tools) {
+            const res = await client.listTools();
+            tools = (res.tools ?? []).map((t) => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema,
+            }));
+            this.tools.set(name, tools);
+        }
+        // apply the optional query/limit filters
+        let filtered = tools;
+        if (query) {
+            const q = query.toLowerCase();
+            filtered = tools.filter((t) => t.name.toLowerCase().includes(q) || (t.description ?? "").toLowerCase().includes(q));
+        }
+        if (limit && limit > 0) {
+            filtered = filtered.slice(0, limit);
+        }
+        return filtered;
+    }
+    // forward a tool call to a backend and return its raw result content.
+    async callTool(name, tool, args) {
+        const client = await this.connect(name, this.configs[name]);
+        const res = await client.callTool({ name: tool, arguments: args });
+        return res.content ?? res;
+    }
+    // reset the idle-close timer for a backend on each use.
+    // used to keep the backend connection alive for a period of time after the last use.
+    resetIdleTimer(name) {
+        const existing = this.idleTimers.get(name);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => void this.close(name), IDLE_TIMEOUT_MS);
+        timer.unref?.();
+        this.idleTimers.set(name, timer);
+    }
+    // close a backend's connection and drop its cached tools/timer.
+    async close(name) {
+        // clear the idle timer
+        const timer = this.idleTimers.get(name);
+        if (timer)
+            clearTimeout(timer);
+        this.idleTimers.delete(name);
+        // delete the cached tools
+        this.tools.delete(name);
+        // close the client
+        const client = this.clients.get(name);
+        if (client) {
+            this.clients.delete(name);
+            try {
+                await client.close();
+            }
+            catch {
+                // best-effort: ignore errors closing the client
+            }
+        }
+    }
+    // close every connected backend (used on shutdown).
+    async closeAll() {
+        await Promise.all([...this.clients.keys()].map((n) => this.close(n)));
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,21 @@
+export interface RemoteBackendConfig {
+    type?: "remote";
+    url: string;
+    headers?: Record<string, string>;
+}
+export interface LocalBackendConfig {
+    type: "local";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export type BackendConfig = (RemoteBackendConfig | LocalBackendConfig) & {
+    /** Optional human/LLM-facing description of what this MCP is for. */
+    instruction?: string;
+    /** Eagerly inject this backend's schemas into the model context instead of keeping it lazy. */
+    favorite?: boolean;
+};
+export interface ProxyConfig {
+    mcpServers: Record<string, BackendConfig>;
+}
+export declare function loadConfig(path: string): ProxyConfig;

package/dist/config.js

@@ -0,0 +1,27 @@
+import { readFileSync } from "node:fs";
+// parse and validate the config file, ensuring every server has url or command.
+export function loadConfig(path) {
+    const raw = readJson(path);
+    const servers = raw.mcpServers;
+    if (!servers || typeof servers !== "object" || Array.isArray(servers)) {
+        throw new Error(`config "${path}" must have an "mcpServers" object`);
+    }
+    // validate that each server has a url or command
+    for (const [name, cfg] of Object.entries(servers)) {
+        if (!cfg || typeof cfg !== "object") {
+            throw new Error(`mcp server "${name}" must be an object`);
+        }
+        const hasUrl = typeof cfg.url === "string";
+        const hasCommand = typeof cfg.command === "string";
+        if (!hasUrl && !hasCommand) {
+            throw new Error(`mcp server "${name}" must have a "url" or "command"`);
+        }
+    }
+    return { mcpServers: servers };
+}
+// read and parse a JSON file into a plain object.
+function readJson(path) {
+    const text = readFileSync(path, "utf8");
+    return JSON.parse(text);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA8BvC,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC;IAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,oCAAoC,CAAC,CAAC;IACvE,CAAC;IACD,iDAAiD;IACjD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,qBAAqB,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,MAAM,GAAG,OAAQ,GAA2B,CAAC,GAAG,KAAK,QAAQ,CAAC;QACpE,MAAM,UAAU,GAAG,OAAQ,GAA0B,CAAC,OAAO,KAAK,QAAQ,CAAC;QAC3E,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,kCAAkC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,OAAwC,EAAE,CAAC;AAClE,CAAC;AAED,kDAAkD;AAClD,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { loadConfig } from "./config.js";
+import { BackendManager } from "./backend.js";
+import packageJson from "../package.json" with { type: "json" };
+const CONFIG_ARG = "--config";
+// parse the --config <path> CLI argument.
+function parseArgs(argv) {
+    const idx = argv.indexOf(CONFIG_ARG);
+    if (idx === -1 || !argv[idx + 1]) {
+        throw new Error(`usage: mcp-lazy-proxy ${CONFIG_ARG} <path-to-config.json>`);
+    }
+    return { configPath: argv[idx + 1] };
+}
+// load config and build the backend manager.
+const { configPath } = parseArgs(process.argv.slice(2));
+const config = loadConfig(configPath);
+const backends = new BackendManager(config.mcpServers);
+// eagerly load the tool schemas of any favorite backends so they are injected
+// into context up front (remaining backends stay lazy). also returns a map of
+// each eager tool name to its owning backend so direct calls route correctly.
+const { tools: favoriteTools, owner: favoriteOwner } = await backends.loadFavorites();
+// advertised server instructions: a brief blurb plus the backend catalog.
+const instructions = [
+    "Lazy MCP proxy. Backend MCP servers are not loaded into context by default; discover them on demand.",
+    "Available backends:",
+    ...backends
+        .list()
+        .map((b) => `- ${b.name}: ${b.instruction ?? "no description"}`),
+    "Workflow: call get_mcp_tools to load a backend's tool schemas, then call_mcp_tool to invoke one.",
+].join("\n");
+// create the MCP server with the tools capability flag.
+// capabilities.tools is a capability flag (not the tool list); the two
+// meta-tools are served by the ListToolsRequestSchema handler below.
+const server = new Server({ name: packageJson.name, version: packageJson.version }, { capabilities: { tools: {} }, instructions });
+// advertise the meta-tools plus any eagerly-loaded favorite backend schemas.
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        ...favoriteTools,
+        {
+            name: "get_mcp_tools",
+            description: "Discover the tools exposed by a configured MCP backend. Returns the backend's instruction (if any) plus a filtered list of tool names, descriptions, and input schemas. Call this before call_mcp_tool to learn what a backend can do.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    mcp: { type: "string", description: "Name of the MCP backend from the proxy config." },
+                    query: { type: "string", description: "Optional substring filter on tool name/description." },
+                    limit: { type: "number", description: "Optional cap on results (default 50)." },
+                },
+                required: ["mcp"],
+            },
+        },
+        {
+            name: "call_mcp_tool",
+            description: "Invoke a tool on a configured MCP backend. Use the tool name and arguments returned by get_mcp_tools.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    mcp: { type: "string", description: "Name of the MCP backend from the proxy config." },
+                    tool: { type: "string", description: "Tool name as returned by get_mcp_tools." },
+                    arguments: {
+                        type: "object",
+                        description: "Arguments per the tool's input schema.",
+                        additionalProperties: true,
+                    },
+                },
+                required: ["mcp", "tool", "arguments"],
+            },
+        },
+    ],
+}));
+// handle calls to the two meta-tools, dispatching to the right backend.
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    try {
+        // get_mcp_tools: load a backend's tool schemas (with optional filter/limit).
+        if (name === "get_mcp_tools") {
+            const mcp = String(args?.mcp ?? "");
+            const query = args?.query ? String(args.query) : undefined;
+            const limit = args?.limit != null ? Number(args.limit) : 50;
+            const handle = await backends.get(mcp);
+            const tools = await handle.listTools(query, limit);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ mcp, instruction: handle.instruction ?? null, tools }, null, 2),
+                    },
+                ],
+            };
+        }
+        // call_mcp_tool: forward a tool invocation to a backend.
+        if (name === "call_mcp_tool") {
+            const mcp = String(args?.mcp ?? "");
+            const tool = String(args?.tool ?? "");
+            const toolArgs = (args?.arguments ?? {});
+            const handle = await backends.get(mcp);
+            const result = await handle.callTool(tool, toolArgs);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        // direct call to an injected favorite tool: route to its owning backend.
+        const ownerObj = favoriteOwner.get(name);
+        if (ownerObj) {
+            const handle = await backends.get(ownerObj.backend);
+            const result = await handle.callTool(ownerObj.realToolName, (args ?? {}));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        return { content: [{ type: "text", text: `unknown tool: ${name}` }], isError: true };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `error: ${err.message}` }],
+            isError: true,
+        };
+    }
+});
+// connect over stdio and clean up backends on shutdown.
+const transport = new StdioServerTransport();
+await server.connect(transport);
+// clean up backends on shutdown.
+process.on("SIGINT", async () => {
+    await backends.closeAll();
+    process.exit(0);
+});
+// clean up backends on termination.
+process.on("SIGTERM", async () => {
+    await backends.closeAll();
+    process.exit(0);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@sarthakpranesh/mcp-lazy-proxy",
+  "version": "0.1.2",
+  "description": "Lazy MCP proxy: exposes get_mcp_tools / call_mcp_tool meta-tools that load backend MCP servers on demand, so only two tool schemas are injected into the model context.",
+  "type": "module",
+  "bin": {
+    "mcp-lazy-proxy": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT"
+}