npm - lazy-mcp - Versions diffs - 1.0.0 - Mend

lazy-mcp 1.0.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 (18) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,63 @@
+# Lazy MCP Proxy
+A proxy tool that converts normal MCP servers to use a lazy-loading pattern with three core tools, dramatically reducing initial context usage and enabling support for hundreds of commands.
+## Overview
+Instead of exposing all tools directly (which can consume many context tokens), this proxy exposes only three meta-tools:
+- `list_commands` - Returns command names and brief descriptions
+- `describe_commands` - Accepts `command_names: Array[String]`, returns full schemas
+- `invoke_command` - Executes commands with `command_name: String, parameters: Object`
+## Installation
+```bash
+npm install -g lazy-mcp
+```
+Or use with npx:
+```bash
+npx lazy-mcp <server-command> [server-args...]
+```
+## Usage
+```bash
+# Run a Python MCP server through the lazy proxy
+lazy-mcp python my_server.py
+# Run a Node.js MCP server through the lazy proxy
+lazy-mcp node my_server.js
+# Pass additional arguments to the original server
+lazy-mcp python my_server.py --config config.json
+```
+## Example
+```bash
+# Original server with many tools
+python my_server.py
+# Exposes: tool1, tool2, tool3, ..., tool100 (uses 100x context)
+# Through lazy proxy
+lazy-mcp python my_server.py
+# Exposes: list_commands, describe_commands, invoke_command (uses 3x context)
+```
+## Development
+```bash
+npm install
+npm run build
+npm run dev -- python example_server.py
+```
+## Benefits
+- **Dramatic reduction** in initial context usage
+- **Progressive tool discovery** - only load schemas when needed
+- **Scales to hundreds** of commands without context bloat
+- **Clean separation** of concerns between discovery and execution

package/dist/cli.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

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

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const server_js_1 = require("./server.js");
+class ExternalMCPServer {
+    constructor(serverCommand, serverArgs = []) {
+        this.serverCommand = serverCommand;
+        this.serverArgs = serverArgs;
+    }
+    async listTools() {
+        return new Promise((resolve, reject) => {
+            const process = (0, child_process_1.spawn)(this.serverCommand, this.serverArgs, {
+                stdio: ['pipe', 'pipe', 'inherit']
+            });
+            const request = {
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'tools/list'
+            };
+            let responseData = '';
+            process.stdout.on('data', (data) => {
+                responseData += data.toString();
+            });
+            process.on('close', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`Server process exited with code ${code}`));
+                    return;
+                }
+                try {
+                    const lines = responseData.trim().split('\n');
+                    for (const line of lines) {
+                        if (line.trim()) {
+                            const response = JSON.parse(line);
+                            if (response.id === 1 && response.result) {
+                                resolve(response.result);
+                                return;
+                            }
+                        }
+                    }
+                    reject(new Error('No valid response received'));
+                }
+                catch (error) {
+                    reject(new Error(`Failed to parse response: ${error}`));
+                }
+            });
+            process.stdin.write(JSON.stringify(request) + '\n');
+            process.stdin.end();
+        });
+    }
+    async callTool(name, arguments_) {
+        return new Promise((resolve, reject) => {
+            const process = (0, child_process_1.spawn)(this.serverCommand, this.serverArgs, {
+                stdio: ['pipe', 'pipe', 'inherit']
+            });
+            const request = {
+                jsonrpc: '2.0',
+                id: 2,
+                method: 'tools/call',
+                params: {
+                    name,
+                    arguments: arguments_
+                }
+            };
+            let responseData = '';
+            process.stdout.on('data', (data) => {
+                responseData += data.toString();
+            });
+            process.on('close', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`Server process exited with code ${code}`));
+                    return;
+                }
+                try {
+                    const lines = responseData.trim().split('\n');
+                    for (const line of lines) {
+                        if (line.trim()) {
+                            const response = JSON.parse(line);
+                            if (response.id === 2 && response.result) {
+                                resolve(response.result);
+                                return;
+                            }
+                        }
+                    }
+                    reject(new Error('No valid response received'));
+                }
+                catch (error) {
+                    reject(new Error(`Failed to parse response: ${error}`));
+                }
+            });
+            process.stdin.write(JSON.stringify(request) + '\n');
+            process.stdin.end();
+        });
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        console.error('Usage: lazy-mcp <server-command> [server-args...]');
+        console.error('Example: lazy-mcp python my_server.py');
+        process.exit(1);
+    }
+    const [serverCommand, ...serverArgs] = args;
+    const originalServer = new ExternalMCPServer(serverCommand, serverArgs);
+    const lazyServer = new server_js_1.LazyMCPServer(originalServer);
+    try {
+        await lazyServer.run();
+    }
+    catch (error) {
+        console.error('Error starting lazy MCP server:', error);
+        process.exit(1);
+    }
+}
+if (require.main === module) {
+    main().catch(console.error);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/proxy.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+import { CommandInfo, CommandSchema, MCPServer, LazyMCPProxy } from './types.js';
+export declare class LazyMCPProxyImpl implements LazyMCPProxy {
+    private mcpServer;
+    private toolsCache;
+    constructor(mcpServer: MCPServer);
+    listCommands(): Promise<CommandInfo[]>;
+    describeCommands(commandNames: string[]): Promise<CommandSchema[]>;
+    invokeCommand(commandName: string, parameters: Record<string, any>): Promise<any>;
+}
+//# sourceMappingURL=proxy.d.ts.map

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

@@ -0,0 +1 @@

+ {"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAW,MAAM,YAAY,CAAC;AAE1F,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAA0B;gBAEhC,SAAS,EAAE,SAAS;IAI1B,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAYtC,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAuBlE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;CAQxF"}

package/dist/proxy.js ADDED Viewed

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LazyMCPProxyImpl = void 0;
+class LazyMCPProxyImpl {
+    constructor(mcpServer) {
+        this.toolsCache = null;
+        this.mcpServer = mcpServer;
+    }
+    async listCommands() {
+        if (!this.toolsCache) {
+            const result = await this.mcpServer.listTools();
+            this.toolsCache = result.tools;
+        }
+        return this.toolsCache.map(tool => ({
+            name: tool.name,
+            description: tool.description
+        }));
+    }
+    async describeCommands(commandNames) {
+        if (!this.toolsCache) {
+            const result = await this.mcpServer.listTools();
+            this.toolsCache = result.tools;
+        }
+        const schemas = [];
+        for (const commandName of commandNames) {
+            const tool = this.toolsCache.find(t => t.name === commandName);
+            if (tool) {
+                schemas.push({
+                    name: tool.name,
+                    description: tool.description,
+                    inputSchema: tool.inputSchema
+                });
+            }
+            else {
+                throw new Error(`Command '${commandName}' not found`);
+            }
+        }
+        return schemas;
+    }
+    async invokeCommand(commandName, parameters) {
+        try {
+            const result = await this.mcpServer.callTool(commandName, parameters);
+            return result.content;
+        }
+        catch (error) {
+            throw new Error(`Failed to invoke command '${commandName}': ${error}`);
+        }
+    }
+}
+exports.LazyMCPProxyImpl = LazyMCPProxyImpl;
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAgB;IAI3B,YAAY,SAAoB;QAFxB,eAAU,GAAqB,IAAI,CAAC;QAG1C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC;QACjC,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,YAAsB;QAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC;QACjC,CAAC;QAED,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;YAC/D,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;iBAC9B,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,YAAY,WAAW,aAAa,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,WAAmB,EAAE,UAA+B;QACtE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YACtE,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,MAAM,KAAK,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;CACF;AAnDD,4CAmDC"}

package/dist/server.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import { MCPServer } from './types.js';
+export declare class LazyMCPServer {
+    private server;
+    private proxy;
+    constructor(originalMcpServer: MCPServer);
+    private setupHandlers;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

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

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAmB;gBAEpB,iBAAiB,EAAE,SAAS;IAiBxC,OAAO,CAAC,aAAa;IA0Hf,GAAG;CAIV"}

package/dist/server.js ADDED Viewed

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LazyMCPServer = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const proxy_js_1 = require("./proxy.js");
+class LazyMCPServer {
+    constructor(originalMcpServer) {
+        this.proxy = new proxy_js_1.LazyMCPProxyImpl(originalMcpServer);
+        this.server = new index_js_1.Server({
+            name: 'lazy-mcp-proxy',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+            return {
+                tools: [
+                    {
+                        name: 'list_commands',
+                        description: 'List all available commands with brief descriptions',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {},
+                        },
+                    },
+                    {
+                        name: 'describe_commands',
+                        description: 'Get detailed schemas for specified commands',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                command_names: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Array of command names to describe',
+                                },
+                            },
+                            required: ['command_names'],
+                        },
+                    },
+                    {
+                        name: 'invoke_command',
+                        description: 'Execute a command with given parameters',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                command_name: {
+                                    type: 'string',
+                                    description: 'Name of the command to execute',
+                                },
+                                parameters: {
+                                    type: 'object',
+                                    description: 'Parameters to pass to the command',
+                                },
+                            },
+                            required: ['command_name', 'parameters'],
+                        },
+                    },
+                ],
+            };
+        });
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case 'list_commands': {
+                        const commands = await this.proxy.listCommands();
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(commands, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'describe_commands': {
+                        const { command_names } = args;
+                        if (!Array.isArray(command_names)) {
+                            throw new Error('command_names must be an array');
+                        }
+                        const schemas = await this.proxy.describeCommands(command_names);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(schemas, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'invoke_command': {
+                        const { command_name, parameters } = args;
+                        if (typeof command_name !== 'string') {
+                            throw new Error('command_name must be a string');
+                        }
+                        if (typeof parameters !== 'object' || parameters === null) {
+                            throw new Error('parameters must be an object');
+                        }
+                        const result = await this.proxy.invokeCommand(command_name, parameters);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: ${errorMessage}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    async run() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+    }
+}
+exports.LazyMCPServer = LazyMCPServer;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/types.d.ts ADDED Viewed

@@ -0,0 +1,36 @@
+export interface CommandInfo {
+    name: string;
+    description: string;
+}
+export interface CommandSchema {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+export interface MCPServer {
+    listTools(): Promise<{
+        tools: MCPTool[];
+    }>;
+    callTool(name: string, arguments_: Record<string, any>): Promise<{
+        content: any[];
+    }>;
+}
+export interface LazyMCPProxy {
+    listCommands(): Promise<CommandInfo[]>;
+    describeCommands(commandNames: string[]): Promise<CommandSchema[]>;
+    invokeCommand(commandName: string, parameters: Record<string, any>): Promise<any>;
+}
+//# 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,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACvC,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACnE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACnF"}

package/dist/types.js ADDED Viewed

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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 ADDED Viewed

@@ -0,0 +1,42 @@
+{
+  "name": "lazy-mcp",
+  "version": "1.0.0",
+  "description": "A proxy tool that converts normal MCP servers to use lazy-loading pattern with three core tools",
+  "main": "dist/server.js",
+  "bin": {
+    "lazy-mcp": "dist/cli.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/gitlab-org/search-team/experiments/lazy-mcp.git"
+  },
+  "homepage": "https://gitlab.com/gitlab-org/search-team/experiments/lazy-mcp#readme",
+  "bugs": {
+    "url": "https://gitlab.com/gitlab-org/search-team/experiments/lazy-mcp/-/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "dev": "ts-node src/cli.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "proxy",
+    "lazy-loading"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.9.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}