@vjsr1982/flowforge-mcp 0.2.0

package/README.md

@@ -0,0 +1,97 @@
+# flowforge-mcp
+
+[Model Context Protocol](https://modelcontextprotocol.io) server for [FlowForge](https://flowforge.pick-app.com.mx) — expose your local-first ETL pipelines to LLM clients (Claude Desktop, Cursor, GitHub Copilot, OpenAI Desktop, custom Agent SDK apps).
+
+> **The LLM never receives your raw rows** unless it explicitly asks for them through `query_sql` or `preview_dataset`. Pipelines run locally; only summaries/schemas cross the wire.
+
+---
+
+## Install
+
+```bash
+# As a one-off (recommended for client config files)
+npx flowforge-mcp --help
+
+# Or globally
+npm i -g flowforge-mcp
+```
+
+Requires Node.js ≥ 20.
+
+## Modes
+
+| Mode | Transport | Auth | Use case |
+|---|---|---|---|
+| `--remote` (default) | stdio ↔ HTTPS | `Authorization: Bearer ff_pat_…` | Web/cloud users |
+| `--local` | stdio ↔ Tauri sidecar IPC | none (per-launch secret) | Desktop app users |
+
+### Get a token (remote mode)
+
+1. Sign in at <https://flowforge.pick-app.com.mx>.
+2. Settings → API Tokens → **Create token** (scope: `mcp` minimum).
+3. Copy the token (shown **once**) — format `ff_pat_<32 chars>`.
+4. Save it as `FLOWFORGE_API_TOKEN` env var, or in `~/.flowforge/token`.
+
+## Claude Desktop config
+
+`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or
+`%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "flowforge": {
+      "command": "npx",
+      "args": ["-y", "flowforge-mcp"],
+      "env": { "FLOWFORGE_API_TOKEN": "ff_pat_..." }
+    }
+  }
+}
+```
+
+## CLI
+
+```text
+flowforge-mcp [--remote] [--base-url <url>] [--token <ff_pat_…>]
+flowforge-mcp --local
+```
+
+| Env var | Default | Notes |
+|---|---|---|
+| `FLOWFORGE_API_TOKEN` | — | required for remote mode |
+| `FLOWFORGE_BASE_URL` | `https://flowforge.pick-app.com.mx` | override for self-hosted |
+
+## Tools (v1)
+
+Always available:
+- `list_pipelines`, `get_pipeline`, `validate_pipeline`, `create_pipeline`
+
+Available when the engine reports `canExecute` (currently desktop sidecar only):
+- `run_pipeline`, `query_sql`, `list_datasets`, `describe_dataset`, `preview_dataset`
+
+## Resources
+
+- `pipeline:///{id}` — pipeline JSON document
+- `pipelines://list` — index of pipelines
+
+## Prompts
+
+- `etl/clean-csv` — design a cleanup pipeline for a dataset
+- `etl/explain-pipeline` — explain a pipeline in plain English
+- `etl/optimize-pipeline` — suggest performance improvements
+
+## Security
+
+- Token format: `ff_pat_<32 base62>`. Hashed (SHA-256) at rest by the FlowForge backend.
+- `query_sql` is read-only — DDL, `ATTACH`, `PRAGMA` and side-effect statements are rejected by the backend's `sql-validator`.
+- Local mode never sends data to the network. The desktop sidecar is keyed by a per-launch secret stored mode `0600` in the OS config dir.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+License: MIT

package/dist/auth.d.ts

@@ -0,0 +1,17 @@
+export interface ResolvedAuth {
+    token: string;
+    baseUrl: string;
+}
+export interface ResolveAuthOptions {
+    cliToken?: string;
+    cliBaseUrl?: string;
+    /** Override env reader for tests. */
+    env?: NodeJS.ProcessEnv;
+    /** Override config-file reader for tests. */
+    readConfigFile?: () => Promise<string | null>;
+}
+export declare function resolveAuth(opts?: ResolveAuthOptions): Promise<ResolvedAuth>;
+export declare class AuthMissingError extends Error {
+    constructor(baseUrl: string, detail?: string);
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CAC9C;AAED,wBAAsB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBtF;AAaD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAgB7C"}

package/dist/auth.js

@@ -0,0 +1,51 @@
+// Resolve the FlowForge API token + base URL from CLI flags or env vars.
+// Order of precedence: CLI flag > environment variable > config file.
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const DEFAULT_BASE_URL = 'https://flowforge.pick-app.com.mx';
+export async function resolveAuth(opts = {}) {
+    const env = opts.env ?? process.env;
+    const baseUrl = (opts.cliBaseUrl ?? env.FLOWFORGE_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+    let token = opts.cliToken ?? env.FLOWFORGE_API_TOKEN;
+    if (!token) {
+        const fromFile = opts.readConfigFile ? await opts.readConfigFile() : await readDefaultConfig();
+        if (fromFile)
+            token = fromFile;
+    }
+    if (!token) {
+        throw new AuthMissingError(baseUrl);
+    }
+    if (!token.startsWith('ff_pat_')) {
+        throw new AuthMissingError(baseUrl, `Token must start with "ff_pat_". Got: ${token.slice(0, 4)}…`);
+    }
+    return { token, baseUrl };
+}
+async function readDefaultConfig() {
+    const path = join(homedir(), '.flowforge', 'token');
+    try {
+        const content = await readFile(path, 'utf8');
+        const trimmed = content.trim();
+        return trimmed || null;
+    }
+    catch {
+        return null;
+    }
+}
+export class AuthMissingError extends Error {
+    constructor(baseUrl, detail) {
+        const url = `${baseUrl}/settings/tokens`;
+        super([
+            'No FlowForge API token found.',
+            detail,
+            `Create one at ${url} and pass it via:`,
+            '  • environment: FLOWFORGE_API_TOKEN=ff_pat_…',
+            '  • CLI flag:    --token ff_pat_…',
+            `  • or save it to ~/.flowforge/token (one line, no quotes)`,
+        ]
+            .filter(Boolean)
+            .join('\n'));
+        this.name = 'AuthMissingError';
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,sEAAsE;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAOhC,MAAM,gBAAgB,GAAG,mCAAmC,CAAA;AAW5D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B,EAAE;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;IACnC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,kBAAkB,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAElG,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,mBAAmB,CAAA;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,MAAM,iBAAiB,EAAE,CAAA;QAC9F,IAAI,QAAQ;YAAE,KAAK,GAAG,QAAQ,CAAA;IAChC,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,gBAAgB,CACxB,OAAO,EACP,yCAAyC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAC9D,CAAA;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC3B,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;QAC9B,OAAO,OAAO,IAAI,IAAI,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe,EAAE,MAAe;QAC1C,MAAM,GAAG,GAAG,GAAG,OAAO,kBAAkB,CAAA;QACxC,KAAK,CACH;YACE,+BAA+B;YAC/B,MAAM;YACN,iBAAiB,GAAG,mBAAmB;YACvC,+CAA+C;YAC/C,mCAAmC;YACnC,4DAA4D;SAC7D;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CACd,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF"}

package/dist/engine/http.d.ts

@@ -0,0 +1,38 @@
+import { request } from 'undici';
+import { type DatasetSchema, type DatasetSummary, type Engine, type PipelineJson, type PipelineSummary, type PreviewResult, type QueryResult, type RunResult, type ValidationResult } from './types.js';
+export interface RemoteHttpEngineOptions {
+    baseUrl: string;
+    token: string;
+    /** Optional fetch wrapper for tests. */
+    fetcher?: typeof request;
+}
+export declare class RemoteHttpEngine implements Engine {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly fetcher;
+    constructor(opts: RemoteHttpEngineOptions);
+    capabilities(): ReturnType<Engine['capabilities']>;
+    listPipelines(filter: {
+        q?: string;
+        limit?: number;
+    }): Promise<PipelineSummary[]>;
+    getPipeline(id: string): Promise<PipelineJson>;
+    createPipeline(input: {
+        name: string;
+        description?: string;
+        content: Record<string, unknown>;
+        tags?: string[];
+    }): Promise<{
+        id: string;
+    }>;
+    validatePipeline(content: Record<string, unknown>): Promise<ValidationResult>;
+    runPipeline(_id: string, _inputs?: Record<string, string>, _outputFormat?: 'json' | 'csv' | 'arrow'): Promise<RunResult>;
+    listDatasets(): Promise<DatasetSummary[]>;
+    describeDataset(_id: string): Promise<DatasetSchema>;
+    previewDataset(_id: string, _limit?: number): Promise<PreviewResult>;
+    querySql(_datasetId: string, _sql: string, _limit?: number): Promise<QueryResult>;
+    private get;
+    private post;
+    private exec;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/engine/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/engine/http.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAChC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,MAAM,EAEX,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,OAAO,CAAA;CACzB;AAOD,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,IAAI,EAAE,uBAAuB;IAMzC,YAAY,IAAI,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAK5C,aAAa,CAAC,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAWjF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI9C,cAAc,CAAC,KAAK,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAChB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAUrB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI7E,WAAW,CACf,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GACvC,OAAO,CAAC,SAAS,CAAC;IAMf,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAKzC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YAMzE,GAAG;YAIH,IAAI;YAIJ,IAAI;CAwCnB"}

package/dist/engine/http.js

@@ -0,0 +1,107 @@
+// Remote engine — issues authenticated REST calls to the FlowForge backend
+// using the user's Personal Access Token (Bearer ff_pat_...).
+//
+// Execution-heavy tools (run_pipeline, query_sql) are not yet exposed in
+// remote v1: the backend returns 501 and `capabilities()` reflects that, so
+// the MCP server simply omits those tools from the registry.
+import { request } from 'undici';
+import { EngineUnavailableError, } from './types.js';
+export class RemoteHttpEngine {
+    baseUrl;
+    token;
+    fetcher;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+        this.token = opts.token;
+        this.fetcher = opts.fetcher ?? request;
+    }
+    capabilities() {
+        // v1 remote: read + create + validate only.
+        return { canExecute: false, canQuerySql: false, hasDatasets: false };
+    }
+    async listPipelines(filter) {
+        const params = new URLSearchParams();
+        if (filter.q)
+            params.set('q', filter.q);
+        if (filter.limit)
+            params.set('limit', String(filter.limit));
+        const qs = params.toString();
+        const json = await this.get(`/api/v1/mcp/pipelines${qs ? `?${qs}` : ''}`);
+        return json.data;
+    }
+    async getPipeline(id) {
+        return await this.get(`/api/v1/mcp/pipelines/${encodeURIComponent(id)}`);
+    }
+    async createPipeline(input) {
+        const json = await this.post(`/api/v1/mcp/pipelines`, {
+            name: input.name,
+            description: input.description,
+            content: input.content,
+            tags: input.tags ?? [],
+        });
+        return { id: json.id };
+    }
+    async validatePipeline(content) {
+        return await this.post(`/api/v1/mcp/pipelines/validate`, { content });
+    }
+    async runPipeline(_id, _inputs, _outputFormat) {
+        throw new EngineUnavailableError('Pipeline execution is not available over the remote MCP transport. Run flowforge-mcp in --local mode (alongside the FlowForge desktop app) to execute pipelines.');
+    }
+    async listDatasets() {
+        const json = await this.get(`/api/v1/mcp/datasets`);
+        return json.data;
+    }
+    async describeDataset(_id) {
+        throw new EngineUnavailableError('describe_dataset requires the local MCP transport.');
+    }
+    async previewDataset(_id, _limit) {
+        throw new EngineUnavailableError('preview_dataset requires the local MCP transport.');
+    }
+    async querySql(_datasetId, _sql, _limit) {
+        throw new EngineUnavailableError('query_sql requires the local MCP transport.');
+    }
+    // ------------------------------------------------------------------ HTTP
+    async get(path) {
+        return await this.exec('GET', path);
+    }
+    async post(path, body) {
+        return await this.exec('POST', path, body);
+    }
+    async exec(method, path, body) {
+        const res = await this.fetcher(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+            },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        const status = res.statusCode;
+        const text = await res.body.text();
+        if (status >= 400) {
+            let parsed = null;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                // not JSON
+            }
+            const msg = parsed?.message ?? text ?? `HTTP ${status}`;
+            if (status === 401) {
+                throw new EngineUnavailableError(`Authentication failed (HTTP 401). Check FLOWFORGE_API_TOKEN. Server said: ${msg}`, 'UNAUTHENTICATED');
+            }
+            if (status === 403) {
+                throw new EngineUnavailableError(`Permission denied (HTTP 403). Token scope insufficient. Server said: ${msg}`, 'FORBIDDEN');
+            }
+            if (status === 501) {
+                throw new EngineUnavailableError(msg, 'NOT_IMPLEMENTED');
+            }
+            throw new Error(`FlowForge API ${method} ${path} failed (${status}): ${msg}`);
+        }
+        if (!text)
+            return {};
+        return JSON.parse(text);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/engine/http.js.map

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

package/dist/engine/local.d.ts

@@ -0,0 +1,35 @@
+import { request } from 'undici';
+import { type DatasetSchema, type DatasetSummary, type Engine, type PipelineJson, type PipelineSummary, type PreviewResult, type QueryResult, type RunResult, type ValidationResult } from './types.js';
+export interface LocalTauriEngineOptions {
+    /** Override for tests. */
+    configDir?: string;
+    /** Override for tests. */
+    fetcher?: typeof request;
+}
+/** Resolve the platform-specific app config dir for `com.flowforge.app`. */
+export declare function defaultConfigDir(): string;
+export declare class LocalTauriEngine implements Engine {
+    private readonly configDir;
+    private readonly fetcher;
+    private conn;
+    constructor(opts?: LocalTauriEngineOptions);
+    capabilities(): ReturnType<Engine['capabilities']>;
+    listPipelines(filter: {
+        q?: string;
+        limit?: number;
+    }): Promise<PipelineSummary[]>;
+    getPipeline(id: string): Promise<PipelineJson>;
+    createPipeline(): Promise<{
+        id: string;
+    }>;
+    validatePipeline(): Promise<ValidationResult>;
+    runPipeline(): Promise<RunResult>;
+    listDatasets(): Promise<DatasetSummary[]>;
+    describeDataset(): Promise<DatasetSchema>;
+    previewDataset(): Promise<PreviewResult>;
+    querySql(): Promise<QueryResult>;
+    private bail;
+    private connect;
+    private get;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/engine/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/engine/local.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAIhC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,MAAM,EAEX,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,OAAO,OAAO,CAAA;CACzB;AAOD,4EAA4E;AAC5E,wBAAgB,gBAAgB,IAAI,MAAM,CAUzC;AAED,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,IAAI,CAAuC;gBAEvC,IAAI,GAAE,uBAA4B;IAK9C,YAAY,IAAI,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAO5C,aAAa,CAAC,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAWjF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI9C,cAAc,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAIzC,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI7C,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;IAIjC,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIzC,eAAe,IAAI,OAAO,CAAC,aAAa,CAAC;IAIzC,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC;IAIxC,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAMtC,OAAO,CAAC,IAAI;YAME,OAAO;YA+BP,GAAG;CA0BlB"}

package/dist/engine/local.js

@@ -0,0 +1,131 @@
+// Local engine — talks to the FlowForge desktop app's HTTP loopback
+// sidecar. On startup the desktop app writes:
+//   • <config>/flowforge/mcp-secret  — 64 hex chars, mode 0600
+//   • <config>/flowforge/mcp-port    — decimal TCP port on 127.0.0.1
+//
+// We read both at construction time, then issue HTTP requests against
+// http://127.0.0.1:<port> with the `X-FlowForge-Secret` header.
+//
+// v0.2 scope: read-only list/get against the file-backed registry the
+// renderer populates via the `register_pipeline` Tauri command. Run /
+// query-SQL / dataset endpoints will be added once the sidecar exposes
+// them.
+import { request } from 'undici';
+import { promises as fs } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+import { EngineUnavailableError, } from './types.js';
+/** Resolve the platform-specific app config dir for `com.flowforge.app`. */
+export function defaultConfigDir() {
+    const home = homedir();
+    switch (platform()) {
+        case 'win32':
+            return join(process.env.APPDATA ?? join(home, 'AppData', 'Roaming'), 'com.flowforge.app');
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', 'com.flowforge.app');
+        default:
+            return join(process.env.XDG_CONFIG_HOME ?? join(home, '.config'), 'com.flowforge.app');
+    }
+}
+export class LocalTauriEngine {
+    configDir;
+    fetcher;
+    conn = null;
+    constructor(opts = {}) {
+        this.configDir = opts.configDir ?? defaultConfigDir();
+        this.fetcher = opts.fetcher ?? request;
+    }
+    capabilities() {
+        // v0.2: read-only pipeline registry; execution still pending.
+        return { canExecute: false, canQuerySql: false, hasDatasets: false };
+    }
+    // -------------------------------------------------------------- Engine API
+    async listPipelines(filter) {
+        const data = await this.get('/v1/pipelines');
+        let out = data;
+        if (filter.q) {
+            const q = filter.q.toLowerCase();
+            out = out.filter((p) => p.name?.toLowerCase().includes(q));
+        }
+        if (filter.limit && filter.limit > 0)
+            out = out.slice(0, filter.limit);
+        return out;
+    }
+    async getPipeline(id) {
+        return await this.get(`/v1/pipelines/${encodeURIComponent(id)}`);
+    }
+    async createPipeline() {
+        this.bail('create_pipeline');
+    }
+    async validatePipeline() {
+        this.bail('validate_pipeline');
+    }
+    async runPipeline() {
+        this.bail('run_pipeline');
+    }
+    async listDatasets() {
+        this.bail('list_datasets');
+    }
+    async describeDataset() {
+        this.bail('describe_dataset');
+    }
+    async previewDataset() {
+        this.bail('preview_dataset');
+    }
+    async querySql() {
+        this.bail('query_sql');
+    }
+    // ----------------------------------------------------------------- Helpers
+    bail(method) {
+        throw new EngineUnavailableError(`${method} is not yet exposed by the desktop sidecar (v0.2 read-only). Tracked in the v0.3 milestone.`);
+    }
+    async connect() {
+        if (!this.conn) {
+            this.conn = (async () => {
+                const ffDir = join(this.configDir, 'flowforge');
+                const secretPath = join(ffDir, 'mcp-secret');
+                const portPath = join(ffDir, 'mcp-port');
+                const [secretRaw, portRaw] = await Promise.all([
+                    fs.readFile(secretPath, 'utf8').catch((err) => {
+                        throw new EngineUnavailableError(`Cannot read ${secretPath} — is the FlowForge desktop app running? (${err.message})`);
+                    }),
+                    fs.readFile(portPath, 'utf8').catch((err) => {
+                        throw new EngineUnavailableError(`Cannot read ${portPath} — is the FlowForge desktop app running? (${err.message})`);
+                    }),
+                ]);
+                const secret = secretRaw.trim();
+                const port = Number.parseInt(portRaw.trim(), 10);
+                if (!secret || !Number.isFinite(port) || port <= 0 || port > 65535) {
+                    throw new EngineUnavailableError(`Invalid sidecar credentials in ${ffDir}. Restart the FlowForge desktop app.`);
+                }
+                return { baseUrl: `http://127.0.0.1:${port}`, secret };
+            })();
+        }
+        return await this.conn;
+    }
+    async get(path) {
+        const { baseUrl, secret } = await this.connect();
+        const res = await this.fetcher(`${baseUrl}${path}`, {
+            method: 'GET',
+            headers: {
+                'X-FlowForge-Secret': secret,
+                Accept: 'application/json',
+            },
+        });
+        const status = res.statusCode;
+        const text = await res.body.text();
+        if (status === 401 || status === 403) {
+            throw new EngineUnavailableError(`Sidecar rejected the secret (HTTP ${status}). Restart the FlowForge desktop app to rotate.`, 'UNAUTHENTICATED');
+        }
+        if (status === 404) {
+            throw new EngineUnavailableError(`Not found: ${path}`);
+        }
+        if (status >= 400) {
+            throw new Error(`Sidecar GET ${path} failed (${status}): ${text}`);
+        }
+        if (!text)
+            return {};
+        return JSON.parse(text);
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/engine/local.js.map

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

package/dist/engine/types.d.ts

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+export declare const PipelineSummary: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    schemaVersion: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    tags: string[];
+    updatedAt: string;
+    description?: string | null | undefined;
+    schemaVersion?: number | undefined;
+}, {
+    id: string;
+    name: string;
+    updatedAt: string;
+    description?: string | null | undefined;
+    tags?: string[] | undefined;
+    schemaVersion?: number | undefined;
+}>;
+export type PipelineSummary = z.infer<typeof PipelineSummary>;
+export declare const PipelineJson: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    content: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    schemaVersion: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    tags: string[];
+    content: Record<string, unknown>;
+    description?: string | null | undefined;
+    schemaVersion?: number | undefined;
+}, {
+    id: string;
+    name: string;
+    content: Record<string, unknown>;
+    description?: string | null | undefined;
+    tags?: string[] | undefined;
+    schemaVersion?: number | undefined;
+}>;
+export type PipelineJson = z.infer<typeof PipelineJson>;
+export interface RunResult {
+    rows: number;
+    schema: {
+        name: string;
+        type: string;
+    }[];
+    elapsedMs: number;
+    downloadUrl?: string;
+}
+export interface QueryResult {
+    rows: unknown[][];
+    schema: {
+        name: string;
+        type: string;
+    }[];
+    truncated: boolean;
+}
+export interface DatasetSchema {
+    columns: {
+        name: string;
+        type: string;
+        nullCount?: number;
+    }[];
+    rowCount?: number;
+}
+export interface PreviewResult {
+    rows: unknown[][];
+    schema: {
+        name: string;
+        type: string;
+    }[];
+}
+export interface DatasetSummary {
+    id: string;
+    name: string;
+    format: string;
+    sizeBytes?: number;
+    createdAt: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: {
+        code: string;
+        message: string;
+        nodeId?: string;
+    }[];
+}
+export interface Engine {
+    listPipelines(filter: {
+        q?: string;
+        limit?: number;
+    }): Promise<PipelineSummary[]>;
+    getPipeline(id: string): Promise<PipelineJson>;
+    createPipeline(input: {
+        name: string;
+        description?: string;
+        content: Record<string, unknown>;
+        tags?: string[];
+    }): Promise<{
+        id: string;
+    }>;
+    validatePipeline(content: Record<string, unknown>): Promise<ValidationResult>;
+    runPipeline(id: string, inputs?: Record<string, string>, outputFormat?: 'json' | 'csv' | 'arrow'): Promise<RunResult>;
+    listDatasets(): Promise<DatasetSummary[]>;
+    describeDataset(id: string): Promise<DatasetSchema>;
+    previewDataset(id: string, limit?: number): Promise<PreviewResult>;
+    querySql(datasetId: string, sql: string, limit?: number): Promise<QueryResult>;
+    capabilities(): {
+        canExecute: boolean;
+        canQuerySql: boolean;
+        hasDatasets: boolean;
+    };
+}
+/** Thrown by engines when the operation is unavailable in this mode. */
+export declare class EngineUnavailableError extends Error {
+    readonly message: string;
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/types.d.ts.map

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

package/dist/engine/types.js

@@ -0,0 +1,32 @@
+// Shared engine contract for MCP tools. Two implementations:
+//   • RemoteHttpEngine — talks to flowforge.pick-app.com.mx via PAT
+//   • LocalTauriEngine — talks to the desktop app's local IPC channel
+import { z } from 'zod';
+export const PipelineSummary = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().nullable().optional(),
+    tags: z.array(z.string()).default([]),
+    schemaVersion: z.number().optional(),
+    updatedAt: z.string(),
+});
+export const PipelineJson = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().nullable().optional(),
+    content: z.record(z.unknown()),
+    tags: z.array(z.string()).default([]),
+    schemaVersion: z.number().optional(),
+});
+/** Thrown by engines when the operation is unavailable in this mode. */
+export class EngineUnavailableError extends Error {
+    message;
+    code;
+    constructor(message, code = 'NOT_IMPLEMENTED') {
+        super(message);
+        this.message = message;
+        this.code = code;
+        this.name = 'EngineUnavailableError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,oEAAoE;AACpE,sEAAsE;AACtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAA;AAGF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAA;AAsEF,wEAAwE;AACxE,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAEpB;IACT;IAFlB,YAC2B,OAAe,EACxB,OAAe,iBAAiB;QAEhD,KAAK,CAAC,OAAO,CAAC,CAAA;QAHW,YAAO,GAAP,OAAO,CAAQ;QACxB,SAAI,GAAJ,IAAI,CAA4B;QAGhD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+// CLI entrypoint. Two modes:
+//   • --remote (default)  → HTTP transport, talks to FlowForge backend
+//   • --local             → stdio transport, talks to FlowForge desktop sidecar
+//
+// Argument parsing is intentionally minimal — no external dep.
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { resolveAuth, AuthMissingError } from './auth.js';
+import { LocalTauriEngine } from './engine/local.js';
+import { RemoteHttpEngine } from './engine/http.js';
+import { createServer } from './server.js';
+function parseArgs(argv) {
+    const opts = { mode: 'remote', help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--local':
+                opts.mode = 'local';
+                break;
+            case '--remote':
+                opts.mode = 'remote';
+                break;
+            case '--base-url':
+                opts.baseUrl = argv[++i];
+                break;
+            case '--token':
+                opts.token = argv[++i];
+                break;
+            case '-h':
+            case '--help':
+                opts.help = true;
+                break;
+        }
+    }
+    return opts;
+}
+function printHelp() {
+    process.stderr.write(`flowforge-mcp — Model Context Protocol server for FlowForge
+
+Usage:
+  flowforge-mcp [--remote] [--base-url <url>] [--token <ff_pat_…>]
+  flowforge-mcp --local
+
+Options:
+  --remote          Connect to a hosted FlowForge backend (default).
+  --local           Use the FlowForge desktop sidecar (no token required).
+  --base-url <url>  Override base URL (default: env FLOWFORGE_BASE_URL or
+                    https://flowforge.pick-app.com.mx).
+  --token <token>   Personal Access Token (overrides env FLOWFORGE_API_TOKEN).
+  -h, --help        Show this help.
+
+Environment:
+  FLOWFORGE_API_TOKEN   PAT created at /settings/tokens.
+  FLOWFORGE_BASE_URL    Override the API base URL.
+
+Examples:
+  FLOWFORGE_API_TOKEN=ff_pat_… flowforge-mcp
+  flowforge-mcp --local
+`);
+}
+async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    if (opts.help) {
+        printHelp();
+        return;
+    }
+    const engine = opts.mode === 'local'
+        ? new LocalTauriEngine()
+        : new RemoteHttpEngine(await resolveAuth({ cliToken: opts.token, cliBaseUrl: opts.baseUrl }).catch((err) => {
+            if (err instanceof AuthMissingError) {
+                process.stderr.write(`${err.message}\n`);
+                process.exit(2);
+            }
+            throw err;
+        }));
+    const server = createServer({ engine });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // server.connect resolves once the transport closes
+}
+main().catch((err) => {
+    const msg = err instanceof Error ? err.stack ?? err.message : String(err);
+    process.stderr.write(`flowforge-mcp fatal: ${msg}\n`);
+    process.exit(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":"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"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export interface PromptTemplate {
+    name: string;
+    title: string;
+    description: string;
+    argsSchema?: Record<string, z.ZodTypeAny>;
+    render: (args: Record<string, string>) => string;
+}
+export declare const PROMPT_TEMPLATES: PromptTemplate[];
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAA;IACzC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAA;CACjD;AAED,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAoD5C,CAAA"}

package/dist/prompts/index.js

@@ -0,0 +1,52 @@
+// Bundled prompt templates surfaced to MCP clients via prompts/list.
+// Keep them short — clients render them as starter messages.
+import { z } from 'zod';
+export const PROMPT_TEMPLATES = [
+    {
+        name: 'etl/clean-csv',
+        title: 'Suggest a cleanup pipeline',
+        description: 'Given a dataset id, ask the model to design a cleanup pipeline (drop nulls, cast types, dedupe).',
+        argsSchema: { datasetId: z.string().describe('Dataset id to inspect') },
+        render: (args) => [
+            `You are designing a FlowForge ETL pipeline for dataset \`${args.datasetId ?? '<datasetId>'}\`.`,
+            '',
+            '1. Call `describe_dataset` to inspect the schema.',
+            '2. Identify columns with high null counts, inconsistent casing, or wrong types.',
+            '3. Propose a sequence of FlowForge nodes (filter_rows / cast_types / handle_nulls / trim_strings / deduplicate) that produces a clean output.',
+            '4. Build the pipeline JSON, then call `validate_pipeline` followed by `create_pipeline`.',
+        ].join('\n'),
+    },
+    {
+        name: 'etl/explain-pipeline',
+        title: 'Explain a pipeline in plain English',
+        description: 'Summarise what a pipeline does, step by step, for non-technical users.',
+        argsSchema: { id: z.string().describe('Pipeline id') },
+        render: (args) => [
+            `Fetch pipeline \`${args.id ?? '<id>'}\` via \`get_pipeline\` and explain in plain English:`,
+            '',
+            '• What datasets it reads.',
+            '• Each transformation, in order.',
+            '• What the final output looks like.',
+            '',
+            'Use bullet points. Avoid SQL jargon.',
+        ].join('\n'),
+    },
+    {
+        name: 'etl/optimize-pipeline',
+        title: 'Suggest pipeline optimizations',
+        description: 'Look for redundant nodes, ordering that limits push-down, and ways to reduce row counts earlier.',
+        argsSchema: { id: z.string().describe('Pipeline id') },
+        render: (args) => [
+            `Fetch pipeline \`${args.id ?? '<id>'}\` and analyse it for performance.`,
+            '',
+            'Look specifically for:',
+            '  – filter_rows that could move earlier in the pipeline.',
+            '  – drop_columns missing before expensive joins.',
+            '  – duplicate / redundant cast_types or handle_nulls steps.',
+            '  – aggregate before a sort that processes the full table.',
+            '',
+            'Return a numbered list of suggestions, each with a one-line rationale.',
+        ].join('\n'),
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,6DAA6D;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,kGAAkG;QACpG,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE;QACvE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACf;YACE,4DAA4D,IAAI,CAAC,SAAS,IAAI,aAAa,KAAK;YAChG,EAAE;YACF,mDAAmD;YACnD,iFAAiF;YACjF,+IAA+I;YAC/I,0FAA0F;SAC3F,CAAC,IAAI,CAAC,IAAI,CAAC;KACf;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EAAE,wEAAwE;QACrF,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE;QACtD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACf;YACE,oBAAoB,IAAI,CAAC,EAAE,IAAI,MAAM,uDAAuD;YAC5F,EAAE;YACF,2BAA2B;YAC3B,kCAAkC;YAClC,qCAAqC;YACrC,EAAE;YACF,sCAAsC;SACvC,CAAC,IAAI,CAAC,IAAI,CAAC;KACf;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,gCAAgC;QACvC,WAAW,EACT,kGAAkG;QACpG,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE;QACtD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACf;YACE,oBAAoB,IAAI,CAAC,EAAE,IAAI,MAAM,oCAAoC;YACzE,EAAE;YACF,wBAAwB;YACxB,0DAA0D;YAC1D,kDAAkD;YAClD,6DAA6D;YAC7D,4DAA4D;YAC5D,EAAE;YACF,wEAAwE;SACzE,CAAC,IAAI,CAAC,IAAI,CAAC;KACf;CACF,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Engine } from './engine/types.js';
+export interface CreateServerOptions {
+    engine: Engine;
+    /** Override version reported to clients. */
+    version?: string;
+}
+export declare function createServer(opts: CreateServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAI/C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,SAAS,CAiOjE"}

package/dist/server.js

@@ -0,0 +1,173 @@
+// MCP server registration: tools, resources, prompts.
+// Dynamic registration based on engine.capabilities() — execution tools
+// only appear when the engine can actually run them.
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { EngineUnavailableError } from './engine/types.js';
+import { PROMPT_TEMPLATES } from './prompts/index.js';
+export function createServer(opts) {
+    const { engine } = opts;
+    const caps = engine.capabilities();
+    const server = new McpServer({
+        name: 'flowforge-mcp',
+        version: opts.version ?? '0.1.0',
+    });
+    // ───────────────────────────────────────────────── Tools — pipelines
+    server.registerTool('list_pipelines', {
+        title: 'List pipelines',
+        description: 'List the user\'s FlowForge pipelines. Optional fuzzy search via `q`. Returns id, name, description, tags and updatedAt.',
+        inputSchema: {
+            q: z.string().optional().describe('Optional case-insensitive fuzzy match on name/description'),
+            limit: z.number().int().positive().max(100).optional(),
+        },
+    }, async ({ q, limit }) => {
+        const pipelines = await engine.listPipelines({ q, limit });
+        return jsonResult(pipelines);
+    });
+    server.registerTool('get_pipeline', {
+        title: 'Get pipeline',
+        description: 'Fetch the full JSON of a pipeline by id, including its node graph.',
+        inputSchema: { id: z.string().min(1) },
+    }, async ({ id }) => {
+        const pipeline = await engine.getPipeline(id);
+        return jsonResult(pipeline);
+    });
+    server.registerTool('validate_pipeline', {
+        title: 'Validate pipeline',
+        description: 'Validate a pipeline JSON document for structural correctness (shape, unique node ids, edge endpoints, no cycles). Use this before calling create_pipeline.',
+        inputSchema: { content: z.record(z.unknown()) },
+    }, async ({ content }) => {
+        const result = await engine.validatePipeline(content);
+        return jsonResult(result);
+    });
+    server.registerTool('create_pipeline', {
+        title: 'Create pipeline',
+        description: 'Create a new pipeline from a JSON document. The content must follow FlowForge schemaVersion 1+ (use validate_pipeline first to catch structural errors).',
+        inputSchema: {
+            name: z.string().min(1).max(255),
+            description: z.string().max(2000).optional(),
+            content: z.record(z.unknown()),
+            tags: z.array(z.string()).optional(),
+        },
+    }, async ({ name, description, content, tags }) => {
+        const created = await engine.createPipeline({ name, description, content, tags });
+        return jsonResult(created);
+    });
+    if (caps.canExecute) {
+        server.registerTool('run_pipeline', {
+            title: 'Run pipeline',
+            description: 'Execute a pipeline end-to-end and return row count + schema. Optionally provide input file overrides via `inputs` (map of node-id → file path / dataset id).',
+            inputSchema: {
+                id: z.string().min(1),
+                inputs: z.record(z.string()).optional(),
+                outputFormat: z.enum(['json', 'csv', 'arrow']).optional(),
+            },
+        }, async ({ id, inputs, outputFormat }) => {
+            const result = await engine.runPipeline(id, inputs, outputFormat);
+            return jsonResult(result);
+        });
+    }
+    // ───────────────────────────────────────────────── Tools — datasets / SQL
+    if (caps.hasDatasets) {
+        server.registerTool('list_datasets', {
+            title: 'List datasets',
+            description: 'List datasets registered with the FlowForge engine.',
+            inputSchema: {},
+        }, async () => {
+            const datasets = await engine.listDatasets();
+            return jsonResult(datasets);
+        });
+        server.registerTool('describe_dataset', {
+            title: 'Describe dataset',
+            description: 'Return the schema (columns + types) and row count of a dataset.',
+            inputSchema: { datasetId: z.string().min(1) },
+        }, async ({ datasetId }) => {
+            const schema = await engine.describeDataset(datasetId);
+            return jsonResult(schema);
+        });
+        server.registerTool('preview_dataset', {
+            title: 'Preview dataset',
+            description: 'Return the first N rows of a dataset (max 100). Useful before writing SQL.',
+            inputSchema: {
+                datasetId: z.string().min(1),
+                limit: z.number().int().positive().max(100).optional(),
+            },
+        }, async ({ datasetId, limit }) => {
+            const preview = await engine.previewDataset(datasetId, limit);
+            return jsonResult(preview);
+        });
+    }
+    if (caps.canQuerySql) {
+        server.registerTool('query_sql', {
+            title: 'Query SQL',
+            description: 'Run a read-only DuckDB SELECT/WITH query against a registered dataset. DDL, ATTACH, PRAGMA and side-effect statements are rejected. Result is automatically truncated to `limit` (default 1000, max 10000) rows.',
+            inputSchema: {
+                datasetId: z.string().min(1),
+                sql: z.string().min(1).max(10_000),
+                limit: z.number().int().positive().max(10_000).optional(),
+            },
+        }, async ({ datasetId, sql, limit }) => {
+            const result = await engine.querySql(datasetId, sql, limit);
+            return jsonResult(result);
+        });
+    }
+    // ───────────────────────────────────────────────── Resources
+    server.registerResource('pipeline', new URL('pipeline:///{id}').toString(), {
+        title: 'Pipeline',
+        description: 'A FlowForge pipeline JSON document.',
+        mimeType: 'application/json',
+    }, async (uri) => {
+        const id = extractIdFromUri(uri.toString(), 'pipeline');
+        const pipeline = await engine.getPipeline(id);
+        return {
+            contents: [
+                {
+                    uri: uri.toString(),
+                    mimeType: 'application/json',
+                    text: JSON.stringify(pipeline, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerResource('pipelines-list', 'pipelines://list', {
+        title: 'All pipelines',
+        description: 'Index of every pipeline owned by the authenticated user.',
+        mimeType: 'application/json',
+    }, async (uri) => {
+        const pipelines = await engine.listPipelines({});
+        return {
+            contents: [
+                {
+                    uri: uri.toString(),
+                    mimeType: 'application/json',
+                    text: JSON.stringify(pipelines, null, 2),
+                },
+            ],
+        };
+    });
+    // ───────────────────────────────────────────────── Prompts
+    for (const tpl of PROMPT_TEMPLATES) {
+        server.registerPrompt(tpl.name, { title: tpl.title, description: tpl.description, argsSchema: tpl.argsSchema ?? {} }, async (args) => ({
+            messages: [
+                {
+                    role: 'user',
+                    content: { type: 'text', text: tpl.render(args) },
+                },
+            ],
+        }));
+    }
+    return server;
+}
+function jsonResult(value) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(value, null, 2) }],
+    };
+}
+function extractIdFromUri(uri, scheme) {
+    const prefix = `${scheme}://`;
+    const idx = uri.indexOf(prefix);
+    if (idx === -1)
+        throw new EngineUnavailableError(`Bad URI: ${uri}`);
+    return decodeURIComponent(uri.slice(idx + prefix.length).replace(/^\/+/, ''));
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@vjsr1982/flowforge-mcp",
+  "version": "0.2.0",
+  "description": "Model Context Protocol server for FlowForge — expose your local-first ETL pipelines to LLM clients (Claude Desktop, Cursor, Copilot, etc.)",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "flowforge-mcp": "./dist/index.js"
+  },
+  "main": "./dist/server.js",
+  "exports": {
+    ".": "./dist/server.js",
+    "./engine": "./dist/engine/types.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "eventsource-parser": "^3.0.0",
+    "undici": "^6.21.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "flowforge",
+    "etl",
+    "duckdb",
+    "llm",
+    "ai-agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flowforge/flow-forge",
+    "directory": "flowforge-mcp"
+  }
+}