JavaScript
The MCP ECharts server dynamically generates interactive charts and visualizations using Apache ECharts for data analysis and visualization.
Key capabilities:
- Generate 15+ chart types including line, bar, pie, radar, scatter, sankey, funnel, gauge, treemap, sunburst, heatmap, candlestick, boxplot, graph, parallel coordinates, and tree charts
- Custom chart generation by providing full ECharts options and configurations
- Multiple export formats - PNG, SVG images, or raw ECharts option JSON
- MinIO integration for storing chart images in object storage with URL returns, fallback to Base64
- Customizable properties including themes (default/dark), dimensions, titles, axis labels, smooth curves, stacking, grouping, and chart-specific options
- Multi-protocol support with stdio transport for desktop apps (VSCode, Claude), SSE, and streamable transport for web applications
- Flexible deployment - run locally or globally via npm with CLI options
- Privacy-focused with zero dependencies and local generation ensuring data security
Generates Apache ECharts diagrams and charts dynamically. Supports all ECharts features including data, style, and themes. Enables exporting to PNG, SVG, and option formats with validation to ensure correct syntax and graphics.
MCP ECharts 
Generate Apache ECharts with AI MCP dynamically for chart generation and data analysis. Also you can use mcp-server-chart to generate chart, graph, map.
✨ Features
- Fully support all features and syntax of
ECharts, include data, style, theme and so on. - Support exporting to
png,svg, andoptionformats, with validation forEChartsto facilitate the model's multi-round output of correct syntax and graphics. - MinIO Integration, store charts in
MinIOobject storage and return URLs instead of Base64 data for better performance and sharing capabilities. - Lightweight, we can install it easily with
zero dependence. - Extremely
secure, fully generated locally, without relying on any remote services.
🤖 Usage
Desktop Applications (stdio transport)
To use with Desktop APP, such as Claude, VSCode, Cline, Cherry Studio, and so on, add the MCP server config below. On Mac system:
On Window system:
Also, you can use it on modelscope, glama.ai, smithery.ai or others with HTTP, SSE Protocol.
🚰 Run with SSE or Streamable transport
Install the package globally.
Run the server with your preferred transport option:
Then you can access the server at:
- SSE transport:
http://localhost:3033/sse - Streamable transport:
http://localhost:3033/mcp
🎮 CLI Options
You can also use the following CLI options when running the MCP server. Command options by run cli with -h.
🗂️ MinIO Configuration (Optional)
For better performance and sharing capabilities, you can configure MinIO object storage to store chart images as URLs instead of Base64 data.
Note
If MinIO is not configured or unavailable, the system automatically falls back to Base64 data output, ensuring compatibility.
We can Integrate with MinIO object storage providers below.
- MinIO: High-performance, S3-compatible object storage. Use MinIO JavaScript Client for direct integration.
- Amazon S3: Use AWS SDK with compatible API endpoint.
- Alibaba Cloud OSS: Use the Alibaba Cloud SDK for OSS services.
- Google Cloud Storage: Integrate using Google Cloud SDK or compatible API.
- Microsoft Azure Blob Storage: Use Azure SDK for Blob storage access.
- Tencent Cloud COS: Use the Tencent Cloud SDK for COS integration.
Also, we can setup MinIO locally for free.
- Install and start MinIO locally:
- Configure environment variables:
🔨 Development
Install dependencies:
Build the server:
Start the MCP server:
🧑🏻💻 Contributors
- lyw405: Supports
15+charting MCP tool. #2 - 2niuhe: Support MCP with SSE and Streaming HTTP. #17
- susuperli: Use
MinIOto save the chart image base64 and return the url. #10 - BQXBQX: Use
@napi-rs/canvasinstead node-canvas. #3 - Meet-student: Add
outputTypeschema for all chart tools. #24 - hustcc: Initial the repo.
📄 License
MIT@hustcc.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Generates Apache ECharts diagrams and charts with AI dynamically, supporting all ECharts features and exporting to png, svg, and option formats.
Related MCP Servers
- TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that generates lightweight ASCII charts directly in terminal environments, supporting line charts, bar charts, scatter plots, histograms, and sparklines without GUI dependencies.Last updated -52TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that generates beautiful chart images from ECharts configurations, supporting various chart types with customizable dimensions.Last updated -65JavaScript