@1mcp/agent 0.21.0 → 0.22.0

package/build/utils/urlGenerator.js

@@ -0,0 +1,208 @@
+import { AgentConfigManager } from '../core/server/agentConfig.js';
+import { PresetManager } from './presetManager.js';
+import logger from '../logger/logger.js';
+/**
+ * URL generator utility for MCP access URLs with preset support
+ */
+export class UrlGenerator {
+    agentConfig;
+    presetManager;
+    constructor() {
+        this.agentConfig = AgentConfigManager.getInstance();
+        this.presetManager = PresetManager.getInstance();
+    }
+    /**
+     * Generate MCP access URL with preset parameter
+     */
+    generatePresetUrl(presetName) {
+        const baseUrl = this.agentConfig.getStreambleHttpUrl();
+        const url = new URL(baseUrl);
+        // Add preset parameter
+        url.searchParams.set('preset', presetName);
+        logger.debug('Generated preset URL', { presetName, url: url.toString() });
+        return url.toString();
+    }
+    /**
+     * Generate MCP access URL with tag filter
+     */
+    generateTagFilterUrl(tagFilter) {
+        const baseUrl = this.agentConfig.getUrl();
+        const url = new URL(baseUrl);
+        // Add tag-filter parameter
+        url.searchParams.set('tag-filter', tagFilter);
+        logger.debug('Generated tag filter URL', { tagFilter, url: url.toString() });
+        return url.toString();
+    }
+    /**
+     * Generate MCP access URL with legacy tags parameter (deprecated)
+     */
+    generateTagsUrl(tags) {
+        const baseUrl = this.agentConfig.getStreambleHttpUrl();
+        const url = new URL(baseUrl);
+        // Add tags parameter
+        url.searchParams.set('tags', tags.join(','));
+        logger.debug('Generated tags URL (deprecated)', { tags, url: url.toString() });
+        return url.toString();
+    }
+    /**
+     * Generate MCP access URL based on options
+     */
+    generateUrl(options = {}) {
+        const baseUrl = this.agentConfig.getStreambleHttpUrl();
+        const url = new URL(baseUrl);
+        // Priority: preset > tag-filter > tags (deprecated)
+        if (options.preset) {
+            // Validate preset exists
+            if (!this.presetManager.hasPreset(options.preset)) {
+                throw new Error(`Preset '${options.preset}' not found`);
+            }
+            url.searchParams.set('preset', options.preset);
+        }
+        else if (options.tagFilter) {
+            url.searchParams.set('tag-filter', options.tagFilter);
+        }
+        else if (options.tags && options.tags.length > 0) {
+            url.searchParams.set('tags', options.tags.join(','));
+        }
+        // Add custom parameters
+        if (options.customParams) {
+            for (const [key, value] of Object.entries(options.customParams)) {
+                url.searchParams.set(key, value);
+            }
+        }
+        // Add authentication parameters if needed
+        if (options.includeAuth && this.agentConfig.isAuthEnabled()) {
+            // Note: Auth parameters would be added here if needed
+            // This is a placeholder for future auth URL parameters
+        }
+        logger.debug('Generated URL', {
+            options,
+            url: url.toString(),
+            baseUrl,
+        });
+        return url.toString();
+    }
+    /**
+     * Get base server URL without parameters
+     */
+    getBaseUrl() {
+        return this.agentConfig.getUrl();
+    }
+    /**
+     * Validate and generate URL for preset
+     */
+    async validateAndGeneratePresetUrl(presetName) {
+        try {
+            // Check if preset exists
+            if (!this.presetManager.hasPreset(presetName)) {
+                return {
+                    url: '',
+                    valid: false,
+                    error: `Preset '${presetName}' not found`,
+                };
+            }
+            // Test preset to ensure it has valid configuration
+            const preset = this.presetManager.getPreset(presetName);
+            if (!preset) {
+                return {
+                    url: '',
+                    valid: false,
+                    error: `Preset '${presetName}' configuration is invalid`,
+                };
+            }
+            // Validate preset configuration
+            const validation = await this.presetManager.validatePreset(presetName, preset);
+            if (!validation.isValid) {
+                return {
+                    url: '',
+                    valid: false,
+                    error: `Preset validation failed: ${validation.errors.join('; ')}`,
+                };
+            }
+            // Generate URL
+            const url = this.generatePresetUrl(presetName);
+            return {
+                url,
+                valid: true,
+            };
+        }
+        catch (error) {
+            logger.error('URL validation and generation failed', { presetName, error });
+            return {
+                url: '',
+                valid: false,
+                error: `Failed to generate URL: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            };
+        }
+    }
+    /**
+     * Parse MCP URL to extract filtering parameters
+     */
+    parseUrl(url) {
+        try {
+            const urlObj = new URL(url);
+            const params = urlObj.searchParams;
+            const result = {
+                otherParams: {},
+            };
+            // Extract filtering parameters
+            if (params.has('preset')) {
+                result.preset = params.get('preset');
+            }
+            else if (params.has('tag-filter')) {
+                result.tagFilter = params.get('tag-filter');
+            }
+            else if (params.has('tags')) {
+                const tagsStr = params.get('tags');
+                if (tagsStr) {
+                    result.tags = tagsStr
+                        .split(',')
+                        .map((tag) => tag.trim())
+                        .filter((tag) => tag.length > 0);
+                }
+            }
+            // Extract other parameters
+            for (const [key, value] of params.entries()) {
+                if (!['preset', 'tag-filter', 'tags'].includes(key)) {
+                    result.otherParams[key] = value;
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            logger.error('Failed to parse URL', { url, error });
+            return { otherParams: {} };
+        }
+    }
+    /**
+     * Check if URL uses preset-based filtering
+     */
+    isPresetUrl(url) {
+        try {
+            const urlObj = new URL(url);
+            return urlObj.searchParams.has('preset');
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Extract preset name from URL
+     */
+    extractPresetName(url) {
+        try {
+            const urlObj = new URL(url);
+            return urlObj.searchParams.get('preset');
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Generate connection string for MCP clients (includes protocol and formatting)
+     */
+    generateConnectionString(options = {}) {
+        return this.generateUrl(options);
+    }
+}
+//# sourceMappingURL=urlGenerator.js.map

package/build/utils/urlGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlGenerator.js","sourceRoot":"","sources":["../../src/utils/urlGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,MAAM,MAAM,qBAAqB,CAAC;AAazC;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,WAAW,CAAqB;IAChC,aAAa,CAAgB;IAErC;QACE,IAAI,CAAC,WAAW,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC;QACpD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IACnD,CAAC;IAED;;OAEG;IACI,iBAAiB,CAAC,UAAkB;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAE7B,uBAAuB;QACvB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE3C,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1E,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACI,oBAAoB,CAAC,SAAiB;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAE7B,2BAA2B;QAC3B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAE9C,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7E,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,IAAc;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAE7B,qBAAqB;QACrB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAE7C,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/E,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,UAAgC,EAAE;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAE7B,oDAAoD;QACpD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,yBAAyB;YACzB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC;YAC1D,CAAC;YACD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,wBAAwB;QACxB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,IAAI,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC;YAC5D,sDAAsD;YACtD,uDAAuD;QACzD,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE;YAC5B,OAAO;YACP,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;YACnB,OAAO;SACR,CAAC,CAAC;QAEH,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACI,UAAU;QACf,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,4BAA4B,CACvC,UAAkB;QAElB,IAAI,CAAC;YACH,yBAAyB;YACzB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9C,OAAO;oBACL,GAAG,EAAE,EAAE;oBACP,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,WAAW,UAAU,aAAa;iBAC1C,CAAC;YACJ,CAAC;YAED,mDAAmD;YACnD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,GAAG,EAAE,EAAE;oBACP,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,WAAW,UAAU,4BAA4B;iBACzD,CAAC;YACJ,CAAC;YAED,gCAAgC;YAChC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC/E,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO;oBACL,GAAG,EAAE,EAAE;oBACP,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,6BAA6B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACnE,CAAC;YACJ,CAAC;YAED,eAAe;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAE/C,OAAO;gBACL,GAAG;gBACH,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5E,OAAO;gBACL,GAAG,EAAE,EAAE;gBACP,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;aAC7F,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,GAAW;QAMzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;YAEnC,MAAM,MAAM,GAAQ;gBAClB,WAAW,EAAE,EAAE;aAChB,CAAC;YAEF,+BAA+B;YAC/B,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACnC,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,CAAC,IAAI,GAAG,OAAO;yBAClB,KAAK,CAAC,GAAG,CAAC;yBACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;yBACxB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YAED,2BAA2B;YAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC5C,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAClC,CAAC;YACH,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YACpD,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,GAAW;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACI,iBAAiB,CAAC,GAAW;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACI,wBAAwB,CAAC,UAAgC,EAAE;QAChE,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1mcp/agent",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "One MCP server to aggregate them all - A unified Model Context Protocol server implementation",
   "keywords": [
     "mcp",
@@ -55,11 +55,15 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.16.0",
+    "@types/prompts": "^2.4.9",
     "body-parser": "^2.2.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.0",
     "cors": "^2.8.5",
     "express": "^5.1.0",
     "express-rate-limit": "^7.5.1",
     "json5": "^2.2.3",
+    "prompts": "^2.4.2",
     "source-map-support": "^0.5.21",
     "tiktoken": "^1.0.22",
     "uuid": "^11.1.0",
@@ -110,6 +114,7 @@
   },
   "scripts": {
     "dev": "tsc-watch --project tsconfig.build.json --onSuccess \"node --env-file=.env build/index.js\"",
+    "start": "node --env-file=.env build/index.js",
     "build": "tsc --project tsconfig.build.json && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
     "clean": "rm -rf build",
     "clean:sea": "rm -f 1mcp 1mcp.exe sea-prep.blob build/bundled.cjs",