n8n-mcp 2.74.0 → 2.75.0

package/dist/mcp/handlers-official-tools.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callOfficialTool = callOfficialTool;
+exports.handleExploreNodeResources = handleExploreNodeResources;
+exports.handleListCatalog = handleListCatalog;
+const zod_1 = require("zod");
+const official_mcp_access_1 = require("./official-mcp-access");
+const n8n_official_mcp_client_1 = require("../services/n8n-official-mcp-client");
+const agents_action_map_1 = require("./agents-action-map");
+const logger_1 = require("../utils/logger");
+const handlers_n8n_manager_1 = require("./handlers-n8n-manager");
+const n8n_errors_1 = require("../utils/n8n-errors");
+const exploreSchema = zod_1.z.object({
+    nodeType: zod_1.z.string().min(1),
+    version: zod_1.z.number(),
+    methodName: zod_1.z.string().min(1),
+    methodType: zod_1.z.enum(['listSearch', 'loadOptions']),
+    credentialType: zod_1.z.string().min(1),
+    credentialId: zod_1.z.string().min(1),
+    filter: zod_1.z.string().optional(),
+    paginationToken: zod_1.z.string().optional(),
+    currentNodeParameters: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    timeoutMs: zod_1.z.number().int().min(agents_action_map_1.MIN_TIMEOUT_MS).max(agents_action_map_1.MAX_TIMEOUT_MS).optional(),
+}).strict();
+const EXPLORE_TOOLS = ['explore_node_resources'];
+async function callOfficialTool(context, toolAliases, args, timeoutMs, label, idempotent) {
+    const client = (0, official_mcp_access_1.getOfficialMcpClient)(context);
+    if (!client)
+        return (0, official_mcp_access_1.notConfiguredResponse)(context, label);
+    try {
+        const caps = await client.capabilities();
+        if (!caps.reachable)
+            return (0, official_mcp_access_1.officialFailure)(new n8n_official_mcp_client_1.OfficialMcpError(caps.error ?? 'OFFICIAL_MCP_TRANSPORT_ERROR', 'n8n MCP server is not reachable'), label);
+        const tool = toolAliases.find(t => caps.toolNames.includes(t));
+        if (!tool)
+            return (0, official_mcp_access_1.officialFailure)(new n8n_official_mcp_client_1.OfficialMcpError('OFFICIAL_MCP_TOOL_UNAVAILABLE', `This instance does not expose ${toolAliases.join(' / ')}`), label);
+        const result = await client.callTool(tool, args, { timeoutMs, idempotent });
+        const data = result.json ?? result.text;
+        if (result.text.startsWith('Input validation error'))
+            return { success: false, action: label, code: 'INVALID_ARGS', error: result.text.slice(0, 2000) };
+        if (result.isError || data?.ok === false) {
+            return { success: false, action: label, officialTool: tool, code: 'OFFICIAL_MCP_ERROR', error: (0, official_mcp_access_1.officialErrorText)(data, undefined), officialError: data };
+        }
+        return { success: true, action: label, officialTool: tool, data, ...(result.truncated ? { truncated: true } : {}) };
+    }
+    catch (err) {
+        const failure = (0, official_mcp_access_1.officialFailure)(err, label);
+        logger_1.logger.warn(`${label} failed`, { code: failure.code });
+        return failure;
+    }
+}
+async function handleExploreNodeResources(args, context) {
+    const parsed = exploreSchema.safeParse(args);
+    if (!parsed.success) {
+        return { success: false, action: 'explore_node_resources', code: 'INVALID_ARGS', error: parsed.error.issues.map(i => `${i.path.join('.') || 'input'}: ${i.message}`).join('; ') };
+    }
+    const { timeoutMs, ...forwarded } = parsed.data;
+    return callOfficialTool(context, EXPLORE_TOOLS, forwarded, timeoutMs ?? agents_action_map_1.DEFAULT_TIMEOUT_MS, 'explore_node_resources', true);
+}
+const CATALOG_TOOLS = ['search_projects'];
+const catalogSchema = zod_1.z.object({
+    kind: zod_1.z.enum(['projects', 'tags']),
+    query: zod_1.z.string().optional(),
+    limit: zod_1.z.number().int().min(1).max(500).optional(),
+}).strict();
+function filterItems(items, query, limit) {
+    const q = query?.trim().toLowerCase();
+    const filtered = q ? items.filter(i => i.name.toLowerCase().includes(q)) : items;
+    return limit ? filtered.slice(0, limit) : filtered;
+}
+async function handleListCatalog(args, context) {
+    const parsed = catalogSchema.safeParse(args);
+    if (!parsed.success) {
+        return { success: false, code: 'INVALID_ARGS', error: parsed.error.issues.map(i => `${i.path.join('.') || 'input'}: ${i.message}`).join('; ') };
+    }
+    const { kind, query, limit } = parsed.data;
+    const api = (0, handlers_n8n_manager_1.getN8nApiClient)(context);
+    if (!api)
+        return { success: false, code: 'NOT_CONFIGURED', error: 'n8n API not configured. Set N8N_API_URL and N8N_API_KEY.' };
+    if (kind === 'tags') {
+        try {
+            const tags = (await api.listTags({ limit: 250 })).data.map(t => ({ id: String(t.id), name: t.name }));
+            return { success: true, kind, backend: 'public-api', data: { items: filterItems(tags, query, limit) } };
+        }
+        catch (err) {
+            return { success: false, kind, code: 'API_ERROR', error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    try {
+        const projects = (await api.listProjects()).map(p => ({ id: p.id, name: p.name, type: p.type, personal: p.type === 'personal' }));
+        return {
+            success: true,
+            kind,
+            backend: 'public-api',
+            data: { teamProjectsEnabled: true, items: filterItems(projects, query, limit) },
+        };
+    }
+    catch (err) {
+        const status = err instanceof n8n_errors_1.N8nApiError ? err.statusCode : undefined;
+        if (status !== 403 && status !== 404) {
+            return { success: false, kind, code: 'API_ERROR', error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    if ((0, official_mcp_access_1.getOfficialMcpClient)(context)) {
+        const official = await callOfficialTool(context, CATALOG_TOOLS, {}, agents_action_map_1.DEFAULT_TIMEOUT_MS, 'list_catalog', true);
+        if (!official.success)
+            return { ...official, kind, backend: 'official-mcp' };
+        const officialData = official.data;
+        const raw = (officialData?.data ?? []);
+        const items = raw.map(p => ({ id: String(p.id), name: String(p.name), type: p.type, personal: p.type === 'personal' }));
+        const teamProjectsEnabled = typeof officialData?.teamProjectsEnabled === 'boolean'
+            ? officialData.teamProjectsEnabled
+            : items.some(p => !p.personal);
+        return {
+            success: true,
+            kind,
+            backend: 'official-mcp',
+            data: { teamProjectsEnabled, items: filterItems(items, query, limit) },
+        };
+    }
+    try {
+        const personalId = await api.resolvePersonalProjectId();
+        return {
+            success: true,
+            kind,
+            backend: 'public-api',
+            data: { teamProjectsEnabled: false, items: filterItems([{ id: personalId, name: 'Personal', type: 'personal', personal: true }], query, limit) },
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            kind,
+            backend: 'public-api',
+            code: 'API_ERROR',
+            error: err instanceof Error ? err.message : String(err),
+            hint: 'Team projects are not available through the Public API on this instance and the personal project could not be resolved. Pass projectId explicitly, or configure N8N_MCP_ACCESS_TOKEN so projects can be listed through n8n\'s MCP server.',
+        };
+    }
+}
+//# sourceMappingURL=handlers-official-tools.js.map

package/dist/mcp/handlers-official-tools.js.map

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

package/dist/mcp/official-mcp-access.d.ts

@@ -0,0 +1,30 @@
+import { InstanceContext } from '../types/instance-context';
+import { OfficialMcpConfig } from '../config/n8n-api';
+import { N8nOfficialMcpClient, OfficialMcpErrorCode } from '../services/n8n-official-mcp-client';
+export interface OfficialMcpFailure {
+    success: false;
+    action?: string;
+    code: string;
+    error: string;
+    hint?: string;
+    officialError?: unknown;
+    details?: Record<string, unknown>;
+}
+export declare function resolveOfficialMcpConfig(context?: InstanceContext): OfficialMcpConfig | null;
+export declare function getOfficialMcpClient(context?: InstanceContext): N8nOfficialMcpClient | null;
+export declare function notConfiguredResponse(context?: InstanceContext, action?: string): OfficialMcpFailure;
+export declare function officialErrorText(data: unknown, officialCode: string | undefined): string;
+export declare function officialFailure(err: unknown, action?: string): OfficialMcpFailure;
+export interface OfficialMcpHealth {
+    configured: boolean;
+    endpoint?: string;
+    reachable?: boolean;
+    toolCount?: number;
+    agentTools?: boolean;
+    checkedAt?: string;
+    error?: OfficialMcpErrorCode;
+    hint?: string;
+}
+export declare function buildOfficialMcpHealth(context: InstanceContext | undefined, live: boolean): Promise<OfficialMcpHealth>;
+export declare function clearOfficialMcpClientCache(): Promise<void>;
+//# sourceMappingURL=official-mcp-access.d.ts.map

package/dist/mcp/official-mcp-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-mcp-access.d.ts","sourceRoot":"","sources":["../../src/mcp/official-mcp-access.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAyD,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EACL,oBAAoB,EAEpB,oBAAoB,EAGrB,MAAM,qCAAqC,CAAC;AAI7C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAkCD,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,iBAAiB,GAAG,IAAI,CAS5F;AAED,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,oBAAoB,GAAG,IAAI,CAmB3F;AA0BD,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAQpG;AAGD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAWzF;AAGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAUjF;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmB5H;AAOD,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjE"}

package/dist/mcp/official-mcp-access.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOfficialMcpConfig = resolveOfficialMcpConfig;
+exports.getOfficialMcpClient = getOfficialMcpClient;
+exports.notConfiguredResponse = notConfiguredResponse;
+exports.officialErrorText = officialErrorText;
+exports.officialFailure = officialFailure;
+exports.buildOfficialMcpHealth = buildOfficialMcpHealth;
+exports.clearOfficialMcpClientCache = clearOfficialMcpClientCache;
+const n8n_api_1 = require("../config/n8n-api");
+const n8n_official_mcp_client_1 = require("../services/n8n-official-mcp-client");
+const cache_utils_1 = require("../utils/cache-utils");
+const logger_1 = require("../utils/logger");
+const clientCache = (0, cache_utils_1.createInstanceCache)((client, key) => {
+    client.close().catch(err => logger_1.logger.debug('Error closing evicted MCP client', { key: key.slice(0, 8), error: err.message }));
+});
+function resolveOfficialMcpConfig(context) {
+    if (context?.n8nApiUrl && (context?.n8nApiKey || context?.n8nMcpAccessToken)) {
+        return (0, n8n_api_1.getOfficialMcpConfigFromContext)(context);
+    }
+    if (process.env.ENABLE_MULTI_TENANT === 'true') {
+        logger_1.logger.warn('Refusing env-credential fallback for official MCP in multi-tenant mode');
+        return null;
+    }
+    return (0, n8n_api_1.getOfficialMcpConfig)();
+}
+function getOfficialMcpClient(context) {
+    const config = resolveOfficialMcpConfig(context);
+    if (!config)
+        return null;
+    const cacheKey = (0, cache_utils_1.createCacheKey)(`${config.endpoint}:${config.token}:${context?.instanceId ?? 'default'}`);
+    const cached = clientCache.get(cacheKey);
+    if (cached) {
+        cache_utils_1.cacheMetrics.recordHit();
+        return cached;
+    }
+    cache_utils_1.cacheMetrics.recordMiss();
+    const client = new n8n_official_mcp_client_1.N8nOfficialMcpClient({ endpoint: config.endpoint, token: config.token, instanceId: context?.instanceId });
+    clientCache.set(cacheKey, client);
+    cache_utils_1.cacheMetrics.recordSet();
+    logger_1.logger.info('Created n8n MCP client', { host: new URL(config.endpoint).host, cacheKey: cacheKey.slice(0, 8) + '...' });
+    return client;
+}
+const SETUP_HINT_MAX_LENGTH = 500;
+function embedderSetupHint(context) {
+    const raw = context?.metadata?.officialMcpSetupHint;
+    if (typeof raw !== 'string')
+        return undefined;
+    const bounded = raw.slice(0, SETUP_HINT_MAX_LENGTH * 2);
+    const stripped = bounded
+        .replace(/[<>]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (stripped.length === 0)
+        return undefined;
+    return stripped.slice(0, SETUP_HINT_MAX_LENGTH);
+}
+function notConfiguredResponse(context, action) {
+    return {
+        success: false,
+        action,
+        code: 'NOT_CONFIGURED',
+        error: 'n8n instance-level MCP access is not configured for this instance',
+        hint: embedderSetupHint(context) ?? n8n_official_mcp_client_1.OFFICIAL_MCP_HINTS.NOT_CONFIGURED,
+    };
+}
+function officialErrorText(data, officialCode) {
+    const obj = data;
+    const raw = typeof obj?.message === 'string'
+        ? obj.message
+        : typeof obj?.error === 'string'
+            ? obj.error
+            : typeof data === 'string'
+                ? data
+                : `n8n returned ${officialCode ?? 'an error'}`;
+    return String(raw).slice(0, 2000);
+}
+function officialFailure(err, action) {
+    const mapped = err instanceof n8n_official_mcp_client_1.OfficialMcpError ? err : (0, n8n_official_mcp_client_1.mapOfficialTransportError)(err);
+    return {
+        success: false,
+        action,
+        code: mapped.code,
+        error: mapped.message,
+        hint: mapped.hint,
+        ...(mapped.status !== undefined ? { details: { status: mapped.status } } : {}),
+    };
+}
+async function buildOfficialMcpHealth(context, live) {
+    const config = resolveOfficialMcpConfig(context);
+    if (!config)
+        return { configured: false, hint: embedderSetupHint(context) ?? n8n_official_mcp_client_1.OFFICIAL_MCP_HINTS.NOT_CONFIGURED };
+    const client = getOfficialMcpClient(context);
+    const caps = live ? await client.capabilities(true) : client.cachedCapabilities();
+    if (!caps)
+        return { configured: true, endpoint: config.endpoint };
+    return {
+        configured: true,
+        endpoint: config.endpoint,
+        reachable: caps.reachable,
+        toolCount: caps.toolCount,
+        agentTools: caps.agentTools,
+        checkedAt: new Date(caps.checkedAt).toISOString(),
+        ...(caps.error ? { error: caps.error, hint: n8n_official_mcp_client_1.OFFICIAL_MCP_HINTS[caps.error] } : {}),
+    };
+}
+async function clearOfficialMcpClientCache() {
+    const clients = [...clientCache.values()];
+    clientCache.clear();
+    await Promise.all(clients.map(c => c.close().catch(() => undefined)));
+}
+//# sourceMappingURL=official-mcp-access.js.map

package/dist/mcp/official-mcp-access.js.map

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

package/dist/mcp/server.d.ts.map

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

package/dist/mcp/server.js

@@ -65,6 +65,8 @@ const template_service_1 = require("../templates/template-service");
 const workflow_validator_1 = require("../services/workflow-validator");
 const n8n_api_1 = require("../config/n8n-api");
 const n8nHandlers = __importStar(require("./handlers-n8n-manager"));
+const handlers_agents_1 = require("./handlers-agents");
+const handlers_official_tools_1 = require("./handlers-official-tools");
 const handlers_workflow_diff_1 = require("./handlers-workflow-diff");
 const tools_documentation_1 = require("./tools-documentation");
 const version_1 = require("../utils/version");
@@ -950,6 +952,7 @@ class N8NDocumentationMCPServer {
                         : { valid: false, errors: [{ field: 'action', message: 'action is required' }] };
                     break;
                 case 'n8n_manage_folders':
+                case 'n8n_manage_agents':
                     validationResult = args.action
                         ? { valid: true, errors: [] }
                         : { valid: false, errors: [{ field: 'action', message: 'action is required' }] };
@@ -1432,6 +1435,14 @@ class N8NDocumentationMCPServer {
                         throw new Error(`Unknown action: ${folderAction}. Valid actions: create, list, get, rename, move, delete`);
                 }
             }
+            case 'n8n_manage_agents':
+                this.validateToolParams(name, args, ['action']);
+                return (0, handlers_agents_1.handleManageAgents)(args, this.instanceContext);
+            case 'n8n_explore_node_resources':
+                return (0, handlers_official_tools_1.handleExploreNodeResources)(args, this.instanceContext);
+            case 'n8n_list_catalog':
+                this.validateToolParams(name, args, ['kind']);
+                return (0, handlers_official_tools_1.handleListCatalog)(args, this.instanceContext);
             case 'n8n_manage_credentials': {
                 this.validateToolParams(name, args, ['action']);
                 const credAction = args.action;