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
, andoption
formats, with validation forECharts
to facilitate the model's multi-round output of correct syntax and graphics. - MinIO Integration, store charts in
MinIO
object 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
MinIO
to save the chart image base64 and return the url. #10 - BQXBQX: Use
@napi-rs/canvas
instead node-canvas. #3 - Meet-student: Add
outputType
schema 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
- -securityFlicense-qualityA Model Context Protocol server that generates beautiful chart images from ECharts configurations, supporting various chart types with customizable dimensions.Last updated -105
- AsecurityAlicenseAqualityEnables AI assistants to generate and render Mermaid diagrams (flowcharts, sequence diagrams, etc.) as PNG/SVG images with local file saving and HTTP access URLs. Supports batch processing and intelligent caching for efficient diagram creation.Last updated -1228MIT License
- AsecurityAlicenseAqualityEnables generation of professional diagrams and interactive prototypes from natural language descriptions using multiple AI models. Supports creating draw.io diagrams, HTML prototypes, and styled mobile app interfaces with Apple HIG and WeChat Mini Program design standards.Last updated -339MIT License
- -securityFlicense-qualityEnables generation and visualization of bar and pie charts from structured data using FastAPI and Altair. Charts are saved as PNG images and served via REST API endpoints with unique URLs.Last updated -