@n8n-as-code/mcp 1.0.0

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { startN8nAsCodeMcpServer } from './services/mcp-server.js';
+const cwdArgIndex = process.argv.indexOf('--cwd');
+const cwd = cwdArgIndex >= 0 ? process.argv[cwdArgIndex + 1] : process.env.N8N_AS_CODE_PROJECT_DIR;
+await startN8nAsCodeMcpServer({ cwd });
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClD,MAAM,GAAG,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;AAEnG,MAAM,uBAAuB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { N8nAsCodeMcpService } from './services/mcp-service.js';
+export { startN8nAsCodeMcpServer } from './services/mcp-server.js';
+export type { N8nAsCodeMcpServiceOptions, CliExecutionResult } from './services/mcp-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { N8nAsCodeMcpService } from './services/mcp-service.js';
+export { startN8nAsCodeMcpServer } from './services/mcp-server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/services/mcp-server.d.ts

@@ -0,0 +1,3 @@
+import { type N8nAsCodeMcpServiceOptions } from './mcp-service.js';
+export declare function startN8nAsCodeMcpServer(options?: N8nAsCodeMcpServiceOptions): Promise<void>;
+//# sourceMappingURL=mcp-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/services/mcp-server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAMxF,wBAAsB,uBAAuB,CAAC,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+GrG"}

package/dist/services/mcp-server.js

@@ -0,0 +1,86 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { N8nAsCodeMcpService } from './mcp-service.js';
+function asJsonText(data) {
+    return JSON.stringify(data, null, 2);
+}
+export async function startN8nAsCodeMcpServer(options = {}) {
+    const service = new N8nAsCodeMcpService(options);
+    const server = new McpServer({
+        name: 'n8n-as-code',
+        version: '1.0.0',
+    });
+    server.tool('search_n8n_knowledge', 'Search the local n8n-as-code knowledge base for nodes, documentation, and examples.', {
+        query: z.string().min(1).describe('Natural-language search query, for example "google sheets" or "AI agent".'),
+        category: z.string().optional().describe('Optional documentation category filter.'),
+        type: z.enum(['node', 'documentation']).optional().describe('Optional result type filter.'),
+        limit: z.number().int().min(1).max(25).optional().describe('Maximum number of results to return.'),
+    }, async ({ query, category, type, limit }) => ({
+        content: [{ type: 'text', text: asJsonText(await service.searchKnowledge(query, { category, type, limit })) }],
+    }));
+    server.tool('get_n8n_node_info', 'Get the full offline schema and metadata for a specific n8n node.', {
+        name: z.string().min(1).describe('Exact or close node name, for example "googleSheets" or "n8n-nodes-base.httpRequest".'),
+    }, async ({ name }) => {
+        try {
+            return {
+                content: [{ type: 'text', text: asJsonText(await service.getNodeInfo(name)) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: error.message }],
+            };
+        }
+    });
+    server.tool('search_n8n_workflow_examples', 'Search the bundled n8n community workflow index for reusable example workflows.', {
+        query: z.string().min(1).describe('Search query, for example "slack notification" or "invoice processing".'),
+        limit: z.number().int().min(1).max(25).optional().describe('Maximum number of workflow examples to return.'),
+    }, async ({ query, limit }) => ({
+        content: [{ type: 'text', text: asJsonText(await service.searchExamples(query, limit)) }],
+    }));
+    server.tool('get_n8n_workflow_example', 'Get metadata and the raw download URL for a specific community workflow example.', {
+        id: z.string().min(1).describe('Workflow example ID from search_n8n_workflow_examples.'),
+    }, async ({ id }) => {
+        try {
+            return {
+                content: [{ type: 'text', text: asJsonText(await service.getExampleInfo(id)) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: error.message }],
+            };
+        }
+    });
+    server.tool('validate_n8n_workflow', 'Validate an n8n workflow from JSON or TypeScript content against the bundled schema.', {
+        workflowContent: z.string().min(1).describe('Workflow source as JSON or .workflow.ts text.'),
+        format: z.enum(['auto', 'json', 'typescript']).optional().describe('Optional workflow format override.'),
+    }, async ({ workflowContent, format }) => {
+        try {
+            const result = await service.validateWorkflow({ workflowContent, format });
+            return {
+                content: [{ type: 'text', text: asJsonText(result) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: error.message }],
+            };
+        }
+    });
+    server.tool('search_n8n_docs', 'Search bundled n8n documentation pages and return matching excerpts.', {
+        query: z.string().min(1).describe('Documentation search query.'),
+        category: z.string().optional().describe('Optional documentation category filter.'),
+        type: z.enum(['node', 'documentation']).optional().describe('Optional result type filter. Defaults to documentation.'),
+        limit: z.number().int().min(1).max(10).optional().describe('Maximum number of pages to return.'),
+    }, async ({ query, category, type, limit }) => ({
+        content: [{ type: 'text', text: asJsonText(await service.searchDocs(query, { category, type, limit })) }],
+    }));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/services/mcp-server.js.map

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

package/dist/services/mcp-service.d.ts

@@ -0,0 +1,39 @@
+export interface N8nAsCodeMcpServiceOptions {
+    cwd?: string;
+}
+export interface ValidateWorkflowOptions {
+    workflowContent: string;
+    format?: 'auto' | 'json' | 'typescript';
+}
+export interface CliExecutionResult {
+    command: string[];
+    cwd: string;
+    exitCode: number;
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    parsedJson?: unknown;
+}
+export declare class N8nAsCodeMcpService {
+    readonly cwd: string;
+    constructor(options?: N8nAsCodeMcpServiceOptions);
+    private getCliEntryPath;
+    private runCliCommand;
+    private runCliJsonCommand;
+    searchKnowledge(query: string, options?: {
+        category?: string;
+        type?: 'node' | 'documentation';
+        limit?: number;
+    }): Promise<any>;
+    getNodeInfo(name: string): Promise<any>;
+    searchDocs(query: string, options?: {
+        category?: string;
+        type?: 'node' | 'documentation';
+        limit?: number;
+    }): Promise<any>;
+    searchExamples(query: string, limit?: number): Promise<any>;
+    getExampleInfo(id: string): Promise<any>;
+    validateWorkflow({ workflowContent, format }: ValidateWorkflowOptions): Promise<any>;
+    readWorkflowFile(path: string): string;
+}
+//# sourceMappingURL=mcp-service.d.ts.map

package/dist/services/mcp-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-service.d.ts","sourceRoot":"","sources":["../../src/services/mcp-service.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,0BAA0B;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAiBD,qBAAa,mBAAmB;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,OAAO,GAAE,0BAA+B;IAIpD,OAAO,CAAC,eAAe;YAMT,aAAa;YAqDb,iBAAiB;IAmB/B,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAQnH,WAAW,CAAC,IAAI,EAAE,MAAM;IAIlB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC;KACb;IAUN,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;IAIhD,cAAc,CAAC,EAAE,EAAE,MAAM;IAInB,gBAAgB,CAAC,EAAE,eAAe,EAAE,MAAe,EAAE,EAAE,uBAAuB;IAsBpF,gBAAgB,CAAC,IAAI,EAAE,MAAM;CAGhC"}

package/dist/services/mcp-service.js

@@ -0,0 +1,142 @@
+import { spawn } from 'child_process';
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { tmpdir } from 'os';
+import { createRequire } from 'module';
+function detectWorkflowFormat(workflowContent, format = 'auto') {
+    if (format === 'typescript') {
+        return true;
+    }
+    if (format === 'json') {
+        return false;
+    }
+    const trimmed = workflowContent.trim();
+    return trimmed.startsWith('import ')
+        || trimmed.startsWith('@workflow')
+        || trimmed.includes('export class');
+}
+export class N8nAsCodeMcpService {
+    cwd;
+    constructor(options = {}) {
+        this.cwd = options.cwd || process.cwd();
+    }
+    getCliEntryPath() {
+        const require = createRequire(import.meta.url);
+        const cliPkg = require.resolve('n8nac/package.json');
+        return join(dirname(cliPkg), 'dist', 'index.js');
+    }
+    async runCliCommand(args, parseJson = false) {
+        const cliEntryPath = this.getCliEntryPath();
+        return new Promise((resolvePromise, reject) => {
+            const child = spawn(process.execPath, [cliEntryPath, ...args], {
+                cwd: this.cwd,
+                env: {
+                    ...process.env,
+                    FORCE_COLOR: '0',
+                    NO_COLOR: '1',
+                },
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout.on('data', (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr.on('data', (chunk) => {
+                stderr += chunk.toString();
+            });
+            child.on('error', reject);
+            child.on('close', (exitCode) => {
+                const trimmedStdout = stdout.trim();
+                const result = {
+                    command: [process.execPath, cliEntryPath, ...args],
+                    cwd: this.cwd,
+                    exitCode: exitCode ?? 1,
+                    success: exitCode === 0,
+                    stdout: trimmedStdout,
+                    stderr: stderr.trim(),
+                };
+                if (parseJson && trimmedStdout) {
+                    try {
+                        result.parsedJson = JSON.parse(trimmedStdout);
+                    }
+                    catch (error) {
+                        result.parsedJson = {
+                            parseError: error.message,
+                            raw: trimmedStdout,
+                        };
+                    }
+                }
+                resolvePromise(result);
+            });
+        });
+    }
+    async runCliJsonCommand(args) {
+        const result = await this.runCliCommand(args, true);
+        const parsed = result.parsedJson;
+        const hasParseError = parsed !== null &&
+            typeof parsed === 'object' &&
+            'parseError' in parsed;
+        if (typeof parsed !== 'undefined' && !hasParseError) {
+            return parsed;
+        }
+        if (!result.success) {
+            throw new Error(result.stderr || result.stdout || `CLI command failed: ${args.join(' ')}`);
+        }
+        throw new Error(`CLI command did not return valid JSON: ${args.join(' ')}`);
+    }
+    searchKnowledge(query, options = {}) {
+        const args = ['skills', 'search', query, '--json'];
+        if (options.category)
+            args.push('--category', options.category);
+        if (options.type)
+            args.push('--type', options.type);
+        if (options.limit)
+            args.push('--limit', String(options.limit));
+        return this.runCliJsonCommand(args);
+    }
+    getNodeInfo(name) {
+        return this.runCliJsonCommand(['skills', 'node-info', name, '--json']);
+    }
+    async searchDocs(query, options = {}) {
+        const args = ['skills', 'search', query, '--json'];
+        if (options.category)
+            args.push('--category', options.category);
+        args.push('--type', options.type ?? 'documentation');
+        if (options.limit)
+            args.push('--limit', String(options.limit));
+        const result = await this.runCliJsonCommand(args);
+        return Array.isArray(result?.results) ? result.results : result;
+    }
+    searchExamples(query, limit = 10) {
+        return this.runCliJsonCommand(['skills', 'examples', 'search', query, '--json', '--limit', String(limit)]);
+    }
+    getExampleInfo(id) {
+        return this.runCliJsonCommand(['skills', 'examples', 'info', id, '--json']);
+    }
+    async validateWorkflow({ workflowContent, format = 'auto' }) {
+        const isTypeScript = detectWorkflowFormat(workflowContent, format);
+        const tempDir = mkdtempSync(join(tmpdir(), 'n8nac-mcp-validate-'));
+        const extension = isTypeScript ? '.workflow.ts' : '.json';
+        const tempFile = join(tempDir, `workflow${extension}`);
+        try {
+            if (!isTypeScript) {
+                try {
+                    JSON.parse(workflowContent);
+                }
+                catch (error) {
+                    throw new Error(`Invalid JSON workflow content: ${error.message}`);
+                }
+            }
+            writeFileSync(tempFile, workflowContent, 'utf8');
+            return await this.runCliJsonCommand(['skills', 'validate', tempFile, '--json']);
+        }
+        finally {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+    }
+    readWorkflowFile(path) {
+        return readFileSync(path, 'utf8');
+    }
+}
+//# sourceMappingURL=mcp-service.js.map

package/dist/services/mcp-service.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@n8n-as-code/mcp",
+  "version": "1.0.0",
+  "description": "Dedicated MCP server for n8n-as-code",
+  "type": "module",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "n8nac-mcp": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -b && chmod +x dist/cli.js",
+    "test": "node --experimental-vm-modules ../../node_modules/.bin/jest",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.6",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EtienneLescot/n8n-as-code",
+    "directory": "packages/mcp"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}