@mario.andreschak/mcp-flujo 3.39.0

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+export type FlujoOperation = 'listTools' | 'callTool' | 'listResources' | 'listResourceTemplates' | 'readResource';
+type FlujoPayload = {
+    name?: string;
+    args?: Record<string, unknown>;
+    uri?: string;
+    cursor?: string;
+};
+export declare function flujoBaseUrl(env?: NodeJS.ProcessEnv): string;
+export declare function toolRoute(name: string): string;
+/** Typed HTTP transport for the stateless standalone mcp-flujo process. */
+export declare function flujoRequest<T>(operation: FlujoOperation, payload?: FlujoPayload): Promise<T>;
+export {};

package/dist/client.js

@@ -0,0 +1,144 @@
+const AUTHORING_TOOLS = new Set([
+    'list_flow_building_blocks',
+    'get_flow_authoring_guide',
+    'validate_flow_spec',
+    'draft_flow',
+    'create_flow',
+    'suggest_tools_for_flow_step',
+    'apply_tools_to_flow_step',
+    'check_flow_plausibility',
+    'search_mcp_marketplace',
+    'install_mcp_server',
+    'install_best_mcp_server',
+]);
+const FLOW_TOOLS = new Set([
+    'list_flows',
+    'discover_capabilities',
+    'execute_flow',
+    'explain_flow',
+    'read_flow',
+    'update_flow',
+    'list_flow_versions',
+    'read_flow_version',
+    'revert_flow',
+    'delete_flow',
+]);
+const SERVER_TOOLS = new Set([
+    'list_mcp_servers',
+    'list_mcp_server_tools',
+    'call_mcp_tool',
+    'restart_mcp_server',
+    'set_mcp_server_enabled',
+]);
+const AUTOMATION_TOOLS = new Set([
+    'list_models',
+    'list_planned_executions',
+    'run_planned_execution',
+    'update_planned_execution',
+    'create_planned_execution',
+    'delete_planned_execution',
+]);
+const STATE_TOOLS = new Set([
+    'list_conversations',
+    'read_conversation',
+    'kv_get',
+    'kv_set',
+]);
+export function flujoBaseUrl(env = process.env) {
+    const configured = env.FLUJO_BASE_URL?.trim();
+    return (configured || 'http://127.0.0.1:4200').replace(/\/+$/, '');
+}
+export function toolRoute(name) {
+    if (AUTHORING_TOOLS.has(name))
+        return '/api/mcp/flujo/authoring';
+    if (FLOW_TOOLS.has(name))
+        return '/api/mcp/flujo/flows';
+    if (SERVER_TOOLS.has(name))
+        return '/api/mcp/flujo/servers';
+    if (AUTOMATION_TOOLS.has(name))
+        return '/api/mcp/flujo/automation';
+    if (STATE_TOOLS.has(name))
+        return '/api/mcp/flujo/state';
+    throw new Error(`Unknown FLUJO tool: ${name}`);
+}
+async function requestJson(path, init = {}, timeoutMs = 30_000) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    timeout.unref?.();
+    try {
+        const response = await fetch(`${flujoBaseUrl()}${path}`, {
+            ...init,
+            cache: 'no-store',
+            signal: controller.signal,
+            headers: {
+                accept: 'application/json',
+                ...(init.body ? { 'content-type': 'application/json' } : {}),
+                ...init.headers,
+            },
+        });
+        const text = await response.text();
+        let body = {};
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                throw new Error(`FLUJO returned a non-JSON response (${response.status}).`);
+            }
+        }
+        if (!response.ok) {
+            const message = body && typeof body === 'object' && 'error' in body && typeof body.error === 'string'
+                ? body.error
+                : `FLUJO request failed (${response.status}).`;
+            throw new Error(message);
+        }
+        return body;
+    }
+    catch (error) {
+        if (controller.signal.aborted) {
+            throw new Error(`FLUJO request timed out after ${timeoutMs}ms.`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/** Typed HTTP transport for the stateless standalone mcp-flujo process. */
+export async function flujoRequest(operation, payload = {}) {
+    if (operation === 'listTools') {
+        return requestJson('/api/mcp/flujo/tools');
+    }
+    if (operation === 'listResources' || operation === 'listResourceTemplates') {
+        const result = await requestJson(`/api/mcp/flujo/resources${payload.cursor ? `?cursor=${encodeURIComponent(payload.cursor)}` : ''}`);
+        if (operation === 'listResources') {
+            return {
+                resources: result.resources,
+                ...(result.nextCursor ? { nextCursor: result.nextCursor } : {}),
+                ...(result.error ? { error: result.error } : {}),
+            };
+        }
+        return {
+            resourceTemplates: result.resourceTemplates,
+            ...(result.error ? { error: result.error } : {}),
+        };
+    }
+    if (operation === 'readResource') {
+        return requestJson('/api/mcp/flujo/resources/read', {
+            method: 'POST',
+            body: JSON.stringify({ uri: payload.uri }),
+        });
+    }
+    const name = payload.name?.trim() ?? '';
+    if (!name)
+        throw new Error('A FLUJO tool name is required.');
+    const requestedTimeout = Number(payload.args?.timeout);
+    const timeoutMs = Number.isFinite(requestedTimeout) && requestedTimeout > 0
+        ? Math.max(30_000, Math.ceil(requestedTimeout * 1000) + 5_000)
+        : 30_000;
+    return requestJson(toolRoute(name), {
+        method: 'POST',
+        body: JSON.stringify({ name, args: payload.args ?? {} }),
+    }, timeoutMs);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export * from './client.js';

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListResourceTemplatesRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { flujoRequest } from './client.js';
+export * from './client.js';
+const server = new Server({ name: '@mario.andreschak/mcp-flujo', version: '0.1.0' }, { capabilities: { tools: {}, resources: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => flujoRequest('listTools'));
+server.setRequestHandler(CallToolRequestSchema, async (request) => flujoRequest('callTool', {
+    name: request.params.name,
+    args: request.params.arguments ?? {},
+}));
+server.setRequestHandler(ListResourcesRequestSchema, async (request) => flujoRequest('listResources', { cursor: request.params?.cursor }));
+server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => flujoRequest('listResourceTemplates'));
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => flujoRequest('readResource', { uri: request.params.uri }));
+const transport = new StdioServerTransport();
+let closing = false;
+async function shutdown() {
+    if (closing)
+        return;
+    closing = true;
+    await server.close().catch(() => undefined);
+}
+process.once('SIGINT', () => void shutdown());
+process.once('SIGTERM', () => void shutdown());
+process.once('SIGHUP', () => void shutdown());
+server.connect(transport).catch((error) => {
+    process.stderr.write(`@mario.andreschak/mcp-flujo failed: ${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,kCAAkC,EAClC,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,GAM1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,cAAc,aAAa,CAAC;AAE5B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,OAAO,EAAE,EACzD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAC/C,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY,CAAkB,WAAW,CAAC,CAAC,CAAC;AACzG,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAChE,YAAY,CAAiB,UAAU,EAAE;IACvC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;IACzB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE;CACrC,CAAC,CACH,CAAC;AACF,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CACrE,YAAY,CAAsB,eAAe,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CACvF,CAAC;AACF,MAAM,CAAC,iBAAiB,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE,CACtE,YAAY,CAA8B,uBAAuB,CAAC,CACnE,CAAC;AACF,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CACpE,YAAY,CAAqB,cAAc,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAC9E,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,IAAI,OAAO,GAAG,KAAK,CAAC;AACpB,KAAK,UAAU,QAAQ;IACrB,IAAI,OAAO;QAAE,OAAO;IACpB,OAAO,GAAG,IAAI,CAAC;IACf,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC;AACD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC9C,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAE9C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvI,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@mario.andreschak/mcp-flujo",
+  "version": "3.39.0",
+  "description": "FLUJO's standalone application MCP server",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "flujo-mcp-flujo": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.30",
+    "typescript": "5.8.3"
+  }
+}