mcp-compress-router 1.0.0 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-compress-router",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Compress all connected MCP servers into a single router MCP to save tokens",
   "license": "MIT",
   "type": "module",
@@ -9,8 +9,10 @@
     "mcp-compress-router": "./build/index.js"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=24",
+    "pnpm": ">=10"
   },
+  "packageManager": "pnpm@10.14.0",
   "publishConfig": {
     "access": "public"
   },
@@ -50,7 +52,7 @@
   "author": "Andrey Meshkov <am@adguard.com>",
   "devDependencies": {
     "@eslint/js": "9.16.0",
-    "@types/node": "22.19.2",
+    "@types/node": "24.13.2",
     "eslint": "9.16.0",
     "husky": "9.1.7",
     "knip": "6.6.2",

package/build/catalog.js

@@ -1,54 +0,0 @@
-/**
- * Builds the immutable tool catalog from discovered server data.
- *
- * @param discovered - Results from parallel discovery.
- * @returns An immutable ToolCatalog.
- */
-export function buildCatalog(discovered) {
-    const toolMap = new Map();
-    const servers = discovered.map((ds) => {
-        for (const tool of ds.tools) {
-            const key = `${ds.name}::${tool.name}`;
-            toolMap.set(key, tool);
-        }
-        return {
-            name: ds.name,
-            description: ds.description,
-            tools: ds.tools,
-        };
-    });
-    return { servers, toolMap };
-}
-/**
- * Looks up tool schemas in the catalog by server and tool names.
- *
- * @param catalog - The tool catalog.
- * @param serverName - The server to look up.
- * @param toolNames - The tool names to retrieve.
- * @returns The matching tool descriptors.
- * @throws If the server or any tool is not found.
- */
-export function lookupTools(catalog, serverName, toolNames) {
-    const server = catalog.servers.find((s) => s.name === serverName);
-    if (!server) {
-        const available = catalog.servers.map((s) => s.name).join(', ');
-        throw new Error(`Server "${serverName}" not found. Available servers: ${available}`);
-    }
-    const results = [];
-    const missing = [];
-    for (const toolName of toolNames) {
-        const key = `${serverName}::${toolName}`;
-        const tool = catalog.toolMap.get(key);
-        if (!tool) {
-            missing.push(toolName);
-        }
-        else {
-            results.push(tool);
-        }
-    }
-    if (missing.length > 0) {
-        const valid = server.tools.map((t) => t.name).join(', ');
-        throw new Error(`Tool(s) not found on server "${serverName}": ${missing.join(', ')}. Valid tools: ${valid}`);
-    }
-    return results;
-}

package/build/cli/config-path-note.js

@@ -1,21 +0,0 @@
-/**
- * Appends the resolved config file path to a command's output when no
- * explicit `-c`/`--config` flag was provided, so the user can see which
- * default configuration file was operated on.
- *
- * When an explicit path was given via `-c`, the output is returned
- * unchanged.
- *
- * @param result - The original command output (may be empty or undefined).
- * @param explicitConfig - The raw `-c` value, or undefined when omitted.
- * @param resolvedPath - The config file path that was actually used.
- * @returns The output followed by a default-path note when `-c` was
- * omitted; otherwise the original output unchanged.
- */
-export function appendConfigPathNote(result, explicitConfig, resolvedPath) {
-    if (explicitConfig !== undefined) {
-        return result;
-    }
-    const note = `Using config: ${resolvedPath}`;
-    return result ? `${result}\n${note}` : note;
-}

package/build/config.js

@@ -1,80 +0,0 @@
-import * as path from 'node:path';
-import * as os from 'node:os';
-import * as fs from 'node:fs/promises';
-/**
- * Resolves the configuration file path.
- *
- * Priority: (1) explicit path argument, (2) MCP_COMPRESS_ROUTER_HOME env var,
- * (3) default ~/.local/share/mcp-compress-router/mcp.json.
- *
- * @param explicitPath - An explicit config path, or undefined.
- * @returns The resolved absolute path to the config file.
- */
-export function resolveConfigPath(explicitPath) {
-    if (explicitPath !== undefined) {
-        return explicitPath;
-    }
-    const home = process.env.MCP_COMPRESS_ROUTER_HOME ??
-        path.join(os.homedir(), '.local', 'share', 'mcp-compress-router');
-    return path.join(home, 'mcp.json');
-}
-/**
- * Loads and validates the MCP configuration file.
- *
- * Reads a JSON file with a top-level mcpServers object, extracts stdio
- * entries, and validates uniqueness. HTTP servers and variable expansion
- * are deferred to later slices.
- *
- * @param configPath - Absolute path to the mcp.json file.
- * @returns An array of validated DownstreamServerConfig objects.
- * @throws If the file is missing, invalid JSON, or contains duplicate names.
- */
-export async function loadConfig(configPath) {
-    const raw = await fs.readFile(configPath, 'utf-8');
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw new Error(`Failed to parse config file: ${configPath}`);
-    }
-    if (typeof parsed !== 'object' || parsed === null) {
-        throw new Error('Config file must contain a JSON object with mcpServers');
-    }
-    const obj = parsed;
-    const mcpServers = obj.mcpServers;
-    if (typeof mcpServers !== 'object' || mcpServers === null) {
-        throw new Error('Config file must contain an mcpServers object');
-    }
-    const names = new Set();
-    const servers = [];
-    for (const [name, entry] of Object.entries(mcpServers)) {
-        if (typeof entry !== 'object' || entry === null) {
-            throw new Error(`Server "${name}" must be an object`);
-        }
-        const server = entry;
-        if (server.type !== 'stdio') {
-            throw new Error(`Server "${name}" has unsupported type "${String(server.type)}"; only "stdio" is supported`);
-        }
-        if (typeof server.command !== 'string' || server.command.length === 0) {
-            throw new Error(`Server "${name}" is missing required "command" field`);
-        }
-        if (names.has(name)) {
-            throw new Error(`Duplicate server name: "${name}"`);
-        }
-        names.add(name);
-        const args = Array.isArray(server.args) ? server.args.map(String) : undefined;
-        const env = server.env !== undefined && typeof server.env === 'object'
-            ? Object.fromEntries(Object.entries(server.env).map(([k, v]) => [k, String(v)]))
-            : undefined;
-        const description = typeof server.description === 'string' ? server.description : undefined;
-        servers.push({
-            name,
-            command: server.command,
-            args,
-            env,
-            description,
-        });
-    }
-    return servers;
-}

package/build/discovery.js

@@ -1,39 +0,0 @@
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-/**
- * Connects to all configured stdio servers in parallel and discovers
- * their tools. Fails fast if any server is unreachable.
- *
- * @param servers - Validated downstream server configs.
- * @returns Discovered server data for each server.
- * @throws If any server cannot be connected or tools cannot be listed.
- */
-export async function connectAndDiscover(servers) {
-    const results = await Promise.all(servers.map(async (server) => {
-        const client = new Client({ name: 'mcp-compress-router', version: '1.0.0' }, { capabilities: {} });
-        const transport = new StdioClientTransport({
-            command: server.command,
-            args: server.args,
-            env: server.env,
-        });
-        try {
-            await client.connect(transport);
-            const listResult = await client.listTools();
-            const tools = listResult.tools.map((t) => ({
-                name: t.name,
-                description: t.description,
-                inputSchema: t.inputSchema,
-            }));
-            return {
-                name: server.name,
-                description: server.description,
-                tools,
-            };
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            throw new Error(`Failed to connect to server "${server.name}": ${message}`);
-        }
-    }));
-    return results;
-}

package/build/text-format.js

@@ -1,24 +0,0 @@
-/**
- * Renders the compact catalog as Markdown text suitable for inclusion
- * in the `get_tool_schema` tool description.
- *
- * Format:
- *   ## {server name}
- *   {description (optional)}
- *   {tool1}, {tool2}, ...
- *
- * @param servers - The catalog server entries.
- * @returns Compact catalog text.
- */
-export function renderCompactCatalog(servers) {
-    const lines = [];
-    for (const server of servers) {
-        lines.push(`## ${server.name}`);
-        if (server.description) {
-            lines.push(server.description);
-        }
-        lines.push(server.tools.map((t) => t.name).join(', '));
-        lines.push(''); // blank line between servers
-    }
-    return lines.join('\n').trimEnd();
-}

package/build/types.js

@@ -1 +0,0 @@
-export {};