@dotzero.ai/export-mcp 1.2.1

package/dist/tools/exports/csv.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export declare const ExportCsvSchema: z.ZodObject<{
+    headers: z.ZodArray<z.ZodString, "many">;
+    rows: z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">, "many">;
+    filename: z.ZodOptional<z.ZodString>;
+    output_path: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    headers: string[];
+    rows: (string | number | boolean | null)[][];
+    output_path?: string | undefined;
+    filename?: string | undefined;
+}, {
+    headers: string[];
+    rows: (string | number | boolean | null)[][];
+    output_path?: string | undefined;
+    filename?: string | undefined;
+}>;
+export type ExportCsvInput = z.infer<typeof ExportCsvSchema>;
+export declare const exportCsvTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        headers: z.ZodArray<z.ZodString, "many">;
+        rows: z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">, "many">;
+        filename: z.ZodOptional<z.ZodString>;
+        output_path: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        headers: string[];
+        rows: (string | number | boolean | null)[][];
+        output_path?: string | undefined;
+        filename?: string | undefined;
+    }, {
+        headers: string[];
+        rows: (string | number | boolean | null)[][];
+        output_path?: string | undefined;
+        filename?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare function executeExportCsv(params: ExportCsvInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/exports/csv.js

@@ -0,0 +1 @@
+import{z}from"zod";import{generateCsv,exportResultToContent}from"../../export-engine.js";export const ExportCsvSchema=z.object({headers:z.array(z.string()).describe("Column headers"),rows:z.array(z.array(z.union([z.string(),z.number(),z.boolean(),z.null()]))).describe("Row data"),filename:z.string().optional().describe("Output filename (without extension)"),output_path:z.string().optional().describe("Custom output file path")}).strict();export const exportCsvTool={name:"export_csv",title:"Export CSV",description:"Export data to a CSV file. Provide column headers and row data.",inputSchema:ExportCsvSchema,annotations:{readOnlyHint:!1,destructiveHint:!1,idempotentHint:!0,openWorldHint:!1}};export async function executeExportCsv(t){const e=generateCsv(t.headers,t.rows,t.filename,t.output_path);return exportResultToContent(e)}

package/dist/tools/exports/index.d.ts

@@ -0,0 +1,2 @@
+export { exportCsvTool, executeExportCsv, type ExportCsvInput } from "./csv.js";
+export { exportXlsxTool, executeExportXlsx, type ExportXlsxInput } from "./xlsx.js";

package/dist/tools/exports/index.js

@@ -0,0 +1 @@
+export{exportCsvTool,executeExportCsv}from"./csv.js";export{exportXlsxTool,executeExportXlsx}from"./xlsx.js";

package/dist/tools/exports/xlsx.d.ts

@@ -0,0 +1,85 @@
+import { z } from "zod";
+export declare const ExportXlsxSchema: z.ZodObject<{
+    sheets: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        headers: z.ZodArray<z.ZodString, "many">;
+        rows: z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">, "many">;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        headers: string[];
+        rows: (string | number | boolean | null)[][];
+    }, {
+        name: string;
+        headers: string[];
+        rows: (string | number | boolean | null)[][];
+    }>, "many">;
+    filename: z.ZodOptional<z.ZodString>;
+    output_path: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    sheets: {
+        name: string;
+        headers: string[];
+        rows: (string | number | boolean | null)[][];
+    }[];
+    output_path?: string | undefined;
+    filename?: string | undefined;
+}, {
+    sheets: {
+        name: string;
+        headers: string[];
+        rows: (string | number | boolean | null)[][];
+    }[];
+    output_path?: string | undefined;
+    filename?: string | undefined;
+}>;
+export type ExportXlsxInput = z.infer<typeof ExportXlsxSchema>;
+export declare const exportXlsxTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        sheets: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            headers: z.ZodArray<z.ZodString, "many">;
+            rows: z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">, "many">;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            headers: string[];
+            rows: (string | number | boolean | null)[][];
+        }, {
+            name: string;
+            headers: string[];
+            rows: (string | number | boolean | null)[][];
+        }>, "many">;
+        filename: z.ZodOptional<z.ZodString>;
+        output_path: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        sheets: {
+            name: string;
+            headers: string[];
+            rows: (string | number | boolean | null)[][];
+        }[];
+        output_path?: string | undefined;
+        filename?: string | undefined;
+    }, {
+        sheets: {
+            name: string;
+            headers: string[];
+            rows: (string | number | boolean | null)[][];
+        }[];
+        output_path?: string | undefined;
+        filename?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare function executeExportXlsx(params: ExportXlsxInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/exports/xlsx.js

@@ -0,0 +1 @@
+import{z}from"zod";import{ExportSheetSchema}from"../../schemas.js";import{generateXlsx,exportResultToContent}from"../../export-engine.js";export const ExportXlsxSchema=z.object({sheets:z.array(ExportSheetSchema).min(1).describe("Worksheet definitions"),filename:z.string().optional().describe("Output filename (without extension)"),output_path:z.string().optional().describe("Custom output file path")}).strict();export const exportXlsxTool={name:"export_xlsx",title:"Export XLSX",description:"Export data to an Excel XLSX file with one or more sheets. Each sheet has headers with bold formatting and auto-fit column widths.",inputSchema:ExportXlsxSchema,annotations:{readOnlyHint:!1,destructiveHint:!1,idempotentHint:!0,openWorldHint:!1}};export async function executeExportXlsx(t){const e=await generateXlsx(t.sheets,t.filename,t.output_path);return exportResultToContent(e)}

package/dist/tools/smart/chart-from-json.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+export declare const ChartFromJsonSchema: z.ZodObject<{
+    title: z.ZodDefault<z.ZodString>;
+    data: z.ZodUnknown;
+    chart_type: z.ZodDefault<z.ZodEnum<["auto", "bar", "line", "pie", "gauge", "oee"]>>;
+} & {
+    output_path: z.ZodOptional<z.ZodString>;
+    width: z.ZodDefault<z.ZodNumber>;
+    height: z.ZodDefault<z.ZodNumber>;
+    format: z.ZodDefault<z.ZodEnum<["png", "jpg"]>>;
+}, "strict", z.ZodTypeAny, {
+    width: number;
+    height: number;
+    format: "png" | "jpg";
+    title: string;
+    chart_type: "bar" | "line" | "pie" | "gauge" | "auto" | "oee";
+    data?: unknown;
+    output_path?: string | undefined;
+}, {
+    width?: number | undefined;
+    height?: number | undefined;
+    data?: unknown;
+    output_path?: string | undefined;
+    format?: "png" | "jpg" | undefined;
+    title?: string | undefined;
+    chart_type?: "bar" | "line" | "pie" | "gauge" | "auto" | "oee" | undefined;
+}>;
+export type ChartFromJsonInput = z.infer<typeof ChartFromJsonSchema>;
+export declare const chartFromJsonTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        title: z.ZodDefault<z.ZodString>;
+        data: z.ZodUnknown;
+        chart_type: z.ZodDefault<z.ZodEnum<["auto", "bar", "line", "pie", "gauge", "oee"]>>;
+    } & {
+        output_path: z.ZodOptional<z.ZodString>;
+        width: z.ZodDefault<z.ZodNumber>;
+        height: z.ZodDefault<z.ZodNumber>;
+        format: z.ZodDefault<z.ZodEnum<["png", "jpg"]>>;
+    }, "strict", z.ZodTypeAny, {
+        width: number;
+        height: number;
+        format: "png" | "jpg";
+        title: string;
+        chart_type: "bar" | "line" | "pie" | "gauge" | "auto" | "oee";
+        data?: unknown;
+        output_path?: string | undefined;
+    }, {
+        width?: number | undefined;
+        height?: number | undefined;
+        data?: unknown;
+        output_path?: string | undefined;
+        format?: "png" | "jpg" | undefined;
+        title?: string | undefined;
+        chart_type?: "bar" | "line" | "pie" | "gauge" | "auto" | "oee" | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare function executeChartFromJson(params: ChartFromJsonInput): Promise<{
+    content: ({
+        type: "text";
+        text: string;
+        data?: undefined;
+        mimeType?: undefined;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: "image/png" | "image/jpeg";
+        text?: undefined;
+    })[];
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/dist/tools/smart/chart-from-json.js

@@ -0,0 +1 @@
+import{z}from"zod";import{BaseChartParams}from"../../schemas.js";import{executeChartBar}from"../charts/bar.js";import{executeChartPie}from"../charts/pie.js";import{executeChartLine}from"../charts/line.js";import{executeChartOeeBreakdown}from"../charts/oee-breakdown.js";import{executeChartGauge}from"../charts/gauge.js";export const ChartFromJsonSchema=z.object({title:z.string().default("Auto Chart").describe("Chart title"),data:z.unknown().describe("JSON data from any DotZero MCP tool (response_format: 'json'). The tool will auto-detect the data shape and pick the best chart type."),chart_type:z.enum(["auto","bar","line","pie","gauge","oee"]).default("auto").describe("Force a specific chart type or let the tool auto-detect")}).merge(BaseChartParams).strict();export const chartFromJsonTool={name:"chart_from_json",title:"Chart from JSON",description:"Auto-detect DotZero JSON data format and generate the most appropriate chart. Pass raw JSON output from any DotZero tool (with response_format: 'json'). Supports OEE data, production summaries, worker rankings, device status, and more.",inputSchema:ChartFromJsonSchema,annotations:{readOnlyHint:!1,destructiveHint:!1,idempotentHint:!0,openWorldHint:!1}};export async function executeChartFromJson(e){const{data:t,title:a}=e,r={width:e.width,height:e.height,format:e.format,output_path:e.output_path};try{const o="string"==typeof t?JSON.parse(t):t;if("oee"===e.chart_type||"auto"===e.chart_type){if(isOeeData(o))return executeChartOeeBreakdown({title:a,availability:asPercent(o.availability),quality:asPercent(o.quality),performance:asPercent(o.performance),oee:void 0!==o.oee?asPercent(o.oee):void 0,...r});if(Array.isArray(o)&&o.length>0&&isOeeData(o[0]))return executeChartOeeBreakdown({title:a,availability:0,quality:0,performance:0,devices:o.map(e=>({name:e.device_name||e.name||"?",availability:asPercent(e.availability),quality:asPercent(e.quality),performance:asPercent(e.performance),oee:void 0!==e.oee?asPercent(e.oee):void 0})),...r})}if("gauge"===e.chart_type||"auto"===e.chart_type&&"number"==typeof o)return executeChartGauge({value:"number"==typeof o?o:0,label:a,min:0,max:100,...r});if(Array.isArray(o)&&o.length>0&&"object"==typeof o[0]){const t=Object.keys(o[0]),i=t.find(e=>["name","device_name","worker_name","label","work_order_id"].includes(e)),n=t.filter(e=>"number"==typeof o[0][e]&&e!==i);if(i&&n.length>0){const t=o.map(e=>String(e[i]));return"pie"===e.chart_type&&1===n.length?executeChartPie({title:a,labels:t,values:o.map(e=>e[n[0]]),chart_type:"pie",...r}):"line"===e.chart_type?executeChartLine({title:a,labels:t,datasets:n.map(e=>({label:e,data:o.map(t=>t[e])})),...r}):executeChartBar({title:a,labels:t,datasets:n.map(e=>({label:e,data:o.map(t=>t[e])})),...r})}}return{content:[{type:"text",text:"Could not auto-detect chart type for the provided data. Try specifying chart_type explicitly or pass data in a simpler format (array of objects with name + numeric fields)."}],isError:!0}}catch(e){return{content:[{type:"text",text:`Error: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}}function isOeeData(e){return e&&"object"==typeof e&&("availability"in e||"quality"in e||"performance"in e)}function asPercent(e){return e<=1&&e>=0?100*e:e}

package/dist/tools/smart/index.d.ts

@@ -0,0 +1,2 @@
+export { chartFromJsonTool, executeChartFromJson, type ChartFromJsonInput } from "./chart-from-json.js";
+export { exportTableFromJsonTool, executeExportTableFromJson, type ExportTableFromJsonInput } from "./table-from-json.js";

package/dist/tools/smart/index.js

@@ -0,0 +1 @@
+export{chartFromJsonTool,executeChartFromJson}from"./chart-from-json.js";export{exportTableFromJsonTool,executeExportTableFromJson}from"./table-from-json.js";

package/dist/tools/smart/table-from-json.d.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+export declare const ExportTableFromJsonSchema: z.ZodObject<{
+    data: z.ZodUnknown;
+    format: z.ZodDefault<z.ZodEnum<["csv", "xlsx"]>>;
+    filename: z.ZodOptional<z.ZodString>;
+    output_path: z.ZodOptional<z.ZodString>;
+    sheet_name: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    format: "csv" | "xlsx";
+    sheet_name: string;
+    data?: unknown;
+    output_path?: string | undefined;
+    filename?: string | undefined;
+}, {
+    data?: unknown;
+    output_path?: string | undefined;
+    format?: "csv" | "xlsx" | undefined;
+    filename?: string | undefined;
+    sheet_name?: string | undefined;
+}>;
+export type ExportTableFromJsonInput = z.infer<typeof ExportTableFromJsonSchema>;
+export declare const exportTableFromJsonTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        data: z.ZodUnknown;
+        format: z.ZodDefault<z.ZodEnum<["csv", "xlsx"]>>;
+        filename: z.ZodOptional<z.ZodString>;
+        output_path: z.ZodOptional<z.ZodString>;
+        sheet_name: z.ZodDefault<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        format: "csv" | "xlsx";
+        sheet_name: string;
+        data?: unknown;
+        output_path?: string | undefined;
+        filename?: string | undefined;
+    }, {
+        data?: unknown;
+        output_path?: string | undefined;
+        format?: "csv" | "xlsx" | undefined;
+        filename?: string | undefined;
+        sheet_name?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export declare function executeExportTableFromJson(params: ExportTableFromJsonInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/dist/tools/smart/table-from-json.js

@@ -0,0 +1 @@
+import{z}from"zod";import{generateCsv,generateXlsx,exportResultToContent}from"../../export-engine.js";export const ExportTableFromJsonSchema=z.object({data:z.unknown().describe("JSON data from any DotZero MCP tool (response_format: 'json'). Accepts an array of objects or a single object."),format:z.enum(["csv","xlsx"]).default("csv").describe("Export format"),filename:z.string().optional().describe("Output filename (without extension)"),output_path:z.string().optional().describe("Custom output file path"),sheet_name:z.string().default("Data").describe("Sheet name (for XLSX)")}).strict();export const exportTableFromJsonTool={name:"export_table_from_json",title:"Export Table from JSON",description:"Auto-convert DotZero JSON data to CSV or XLSX. Pass raw JSON output from any DotZero tool (with response_format: 'json'). Automatically extracts headers from object keys.",inputSchema:ExportTableFromJsonSchema,annotations:{readOnlyHint:!1,destructiveHint:!1,idempotentHint:!0,openWorldHint:!1}};export async function executeExportTableFromJson(t){try{const e="string"==typeof t.data?JSON.parse(t.data):t.data;let o;if(Array.isArray(e))o=e;else{if("object"!=typeof e||null===e)return{content:[{type:"text",text:"Error: Data must be a JSON object or array of objects."}],isError:!0};o="data"in e&&Array.isArray(e.data)?e.data:[e]}if(0===o.length)return{content:[{type:"text",text:"No data to export (empty array)."}],isError:!0};const r=new Set;for(const t of o)if("object"==typeof t&&null!==t)for(const e of Object.keys(t))r.add(e);const n=[...r],a=o.map(t=>n.map(e=>{const o=t[e];return null==o?null:"object"==typeof o?JSON.stringify(o):o}));if("xlsx"===t.format){const e=await generateXlsx([{name:t.sheet_name,headers:n,rows:a}],t.filename,t.output_path);return exportResultToContent(e)}{const e=generateCsv(n,a,t.filename,t.output_path);return exportResultToContent(e)}}catch(t){return{content:[{type:"text",text:`Error: ${t instanceof Error?t.message:String(t)}`}],isError:!0}}}

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * TypeScript interfaces for export-mcp
+ */
+export interface ChartDataset {
+    label: string;
+    data: number[];
+    color?: string;
+    borderColor?: string;
+    backgroundColor?: string;
+    fill?: boolean;
+}
+export interface ScatterPoint {
+    x: number;
+    y: number;
+}
+export interface ScatterDataset {
+    label: string;
+    data: ScatterPoint[];
+    color?: string;
+}
+export interface ChartOptions {
+    stacked?: boolean;
+    horizontal?: boolean;
+    show_legend?: boolean;
+    show_grid?: boolean;
+    x_label?: string;
+    y_label?: string;
+    min_y?: number;
+    max_y?: number;
+}
+export interface GaugeThreshold {
+    value: number;
+    color: string;
+}
+export interface ControlChartData {
+    values: number[];
+    labels?: string[];
+    ucl: number;
+    cl: number;
+    lcl: number;
+    usl?: number;
+    lsl?: number;
+}
+export interface TimelineSegment {
+    start: string;
+    end: string;
+    state: string;
+    color?: string;
+}
+export interface TimelineData {
+    device_name?: string;
+    segments: TimelineSegment[];
+}
+export interface MultiChartItem {
+    type: "bar" | "line" | "pie" | "gauge";
+    title: string;
+    config: Record<string, unknown>;
+}
+export interface ExportSheet {
+    name: string;
+    headers: string[];
+    rows: (string | number | boolean | null)[][];
+}
+export interface ChartResult {
+    filePath: string;
+    width: number;
+    height: number;
+    base64: string;
+    mimeType: "image/png" | "image/jpeg";
+}
+export interface ExportResult {
+    filePath: string;
+    rowCount: number;
+    preview: string;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export{};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@dotzero.ai/export-mcp",
+  "version": "1.2.1",
+  "description": "MCP server for chart generation and data export - PNG/JPG charts, CSV/XLSX exports",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "export-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "chart",
+    "export",
+    "csv",
+    "xlsx",
+    "png",
+    "manufacturing",
+    "oee",
+    "spc",
+    "visualization"
+  ],
+  "author": {
+    "name": "DotZero",
+    "url": "https://dotzero.app"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/dotzero/dz-ai.git",
+    "directory": "packages/export-mcp"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "@napi-rs/canvas": "^0.1.65",
+    "chart.js": "^4.4.8",
+    "chartjs-node-canvas": "^4.1.6",
+    "chartjs-plugin-annotation": "^3.1.0",
+    "exceljs": "^4.4.0",
+    "express": "^4.21.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc && find dist -name '*.js' -exec npx terser {} --compress --mangle -o {} \\;",
+    "clean": "rm -rf dist"
+  }
+}