hustcc · hustcc · Aug 13, 2025 · Aug 13, 2025 · Aug 13, 2025 · Aug 13, 2025
diff --git a/README.md b/README.md
@@ -171,6 +171,7 @@ npm run start
 - [2niuhe](https://github.com/2niuhe): Support MCP with SSE and Streaming HTTP. [#17](https://github.com/hustcc/mcp-echarts/issues/17)
 - [susuperli](https://github.com/susuperli): Use `MinIO` to save the chart image base64 and return the url. [#10](https://github.com/hustcc/mcp-echarts/issues/10)
 - [BQXBQX](https://github.com/BQXBQX): Use `@napi-rs/canvas` instead node-canvas. [#3](https://github.com/hustcc/mcp-echarts/issues/3)
+- [Meet-student](https://github.com/Meet-student): Add `outputType` schema for all chart tools. [#24](https://github.com/hustcc/mcp-echarts/issues/24)
 - [hustcc](https://github.com/hustcc): Initial the repo.
 
 

diff --git a/__tests__/schema/bar.json b/__tests__/schema/bar.json
@@ -68,6 +68,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/boxplot.json b/__tests__/schema/boxplot.json
@@ -58,6 +58,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/candlestick.json b/__tests__/schema/candlestick.json
@@ -65,6 +65,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/funnel.json b/__tests__/schema/funnel.json
@@ -44,6 +44,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/gauge.json b/__tests__/schema/gauge.json
@@ -54,6 +54,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/graph.json b/__tests__/schema/graph.json
@@ -88,6 +88,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/heatmap.json b/__tests__/schema/heatmap.json
@@ -58,6 +58,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/line.json b/__tests__/schema/line.json
@@ -76,6 +76,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/parallel.json b/__tests__/schema/parallel.json
@@ -55,6 +55,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data", "dimensions"],

diff --git a/__tests__/schema/pie.json b/__tests__/schema/pie.json
@@ -49,6 +49,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/radar.json b/__tests__/schema/radar.json
@@ -48,6 +48,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/sankey.json b/__tests__/schema/sankey.json
@@ -54,6 +54,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/scatter.json b/__tests__/schema/scatter.json
@@ -54,6 +54,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/sunburst.json b/__tests__/schema/sunburst.json
@@ -51,6 +51,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/tree.json b/__tests__/schema/tree.json
@@ -77,6 +77,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/__tests__/schema/treemap.json b/__tests__/schema/treemap.json
@@ -51,6 +51,12 @@
         "exclusiveMinimum": 0,
         "default": 800,
         "description": "Set the width of the chart, default is 800px."
+      },
+      "outputType": {
+        "type": "string",
+        "enum": ["png", "svg", "option"],
+        "default": "png",
+        "description": "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option."
       }
     },
     "required": ["data"],

diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "mcp-echarts",
   "description": "❤️ Generate visual charts using Apache ECharts with AI MCP dynamically.",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "main": "build/index.js",
   "scripts": {
     "test": "vitest",

diff --git a/src/tools/bar.ts b/src/tools/bar.ts
@@ -5,6 +5,7 @@ import {
   AxisXTitleSchema,
   AxisYTitleSchema,
   HeightSchema,
+  OutputTypeSchema,
   ThemeSchema,
   TitleSchema,
   WidthSchema,
@@ -54,6 +55,7 @@ export const generateBarChartTool = {
     theme: ThemeSchema,
     title: TitleSchema,
     width: WidthSchema,
+    outputType: OutputTypeSchema,
   }),
   run: async (params: {
     axisXTitle?: string;
@@ -65,6 +67,7 @@ export const generateBarChartTool = {
     theme?: "default" | "dark";
     title?: string;
     width: number;
+    outputType?: "png" | "svg" | "option";
   }) => {
     const {
       axisXTitle,
@@ -76,6 +79,7 @@ export const generateBarChartTool = {
       theme,
       title,
       width,
+      outputType,
     } = params;
 
     // Check if data has group field for multiple series
@@ -169,7 +173,7 @@ export const generateBarChartTool = {
       width,
       height,
       theme,
-      "png",
+      outputType,
       "generate_bar_chart",
     );
   },

diff --git a/src/tools/boxplot.ts b/src/tools/boxplot.ts
@@ -5,6 +5,7 @@ import {
   AxisXTitleSchema,
   AxisYTitleSchema,
   HeightSchema,
+  OutputTypeSchema,
   ThemeSchema,
   TitleSchema,
   WidthSchema,
@@ -41,6 +42,7 @@ export const generateBoxplotChartTool = {
     theme: ThemeSchema,
     title: TitleSchema,
     width: WidthSchema,
+    outputType: OutputTypeSchema,
   }),
   run: async (params: {
     axisXTitle?: string;
@@ -50,9 +52,18 @@ export const generateBoxplotChartTool = {
     theme?: "default" | "dark";
     title?: string;
     width: number;
+    outputType?: "png" | "svg" | "option";
   }) => {
-    const { axisXTitle, axisYTitle, data, height, theme, title, width } =
-      params;
+    const {
+      axisXTitle,
+      axisYTitle,
+      data,
+      height,
+      theme,
+      title,
+      width,
+      outputType,
+    } = params;
 
     // Group data by category and optional group
     const hasGroups = data.some((item) => item.group);
@@ -186,7 +197,7 @@ export const generateBoxplotChartTool = {
       width,
       height,
       theme,
-      "png",
+      outputType,
       "generate_boxplot_chart",
     );
   },

diff --git a/src/tools/candlestick.ts b/src/tools/candlestick.ts
@@ -3,6 +3,7 @@ import { z } from "zod";
 import { generateChartImage } from "../utils";
 import {
   HeightSchema,
+  OutputTypeSchema,
   ThemeSchema,
   TitleSchema,
   WidthSchema,
@@ -40,6 +41,7 @@ export const generateCandlestickChartTool = {
     theme: ThemeSchema,
     title: TitleSchema,
     width: WidthSchema,
+    outputType: OutputTypeSchema,
   }),
   run: async (params: {
     data: Array<{
@@ -55,8 +57,17 @@ export const generateCandlestickChartTool = {
     theme?: "default" | "dark";
     title?: string;
     width: number;
+    outputType?: "png" | "svg" | "option";
   }) => {
-    const { data, height, showVolume = false, theme, title, width } = params;
+    const {
+      data,
+      height,
+      showVolume = false,
+      theme,
+      title,
+      width,
+      outputType,
+    } = params;
 
     // Sort data by date
     const sortedData = [...data].sort(
@@ -216,7 +227,7 @@ export const generateCandlestickChartTool = {
       width,
       height,
       theme,
-      "png",
+      outputType,
       "generate_candlestick_chart",
     );
   },

diff --git a/src/tools/echarts.ts b/src/tools/echarts.ts
@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { generateChartImage } from "../utils";
+import { OutputTypeSchema } from "../utils/schema";
 
 function isValidEChartsOption(option: string): boolean {
   try {
@@ -89,13 +90,7 @@ ATTENTION: A valid ECharts option must be a valid JSON string, and cannot be emp
       .describe("ECharts theme, optional. Default is 'default'.")
       .optional()
       .default("default"),
-    outputType: z
-      .enum(["png", "svg", "option"])
-      .describe(
-        "The output type of the diagram. Can be 'png', 'svg' or 'option'. Default is 'png', 'png' will return the rendered PNG image, 'svg' will return the rendered SVG string, and 'option' will return the valid ECharts option.",
-      )
-      .optional()
-      .default("png"),
+    outputType: OutputTypeSchema,
   }),
   run: async (params: {
     echartsOption: string;