-
securityF
license-
qualityA Model Context Protocol server that generates beautiful chart images from ECharts configurations, supporting various chart types with customizable dimensions.
Last updated -
0
5
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
✨ 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:
{
"mcpServers": {
"mcp-echarts": {
"command": "npx",
"args": [
"-y",
"mcp-echarts"
]
}
}
}
On Window system:
{
"mcpServers": {
"mcp-echarts": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"mcp-echarts"
]
}
}
}
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.
npm install -g mcp-echarts
Run the server with your preferred transport option:
# For SSE transport (default endpoint: /sse)
mcp-echarts -t sse
# For Streamable transport with custom endpoint
mcp-echarts -t streamable
Then you can access the server at:
SSE transport:
http://localhost:3033/sseStreamable 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.
MCP ECharts CLI
Options:
--transport, -t Specify the transport protocol: "stdio", "sse", or "streamable" (default: "stdio")
--port, -p Specify the port for SSE or streamable transport (default: 3033)
--endpoint, -e Specify the endpoint for the transport:
- For SSE: default is "/sse"
- For streamable: default is "/mcp"
--help, -h Show this help message
🗂️ 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 toBase64 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.
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:
# Download MinIO (macOS example) brew install minio/stable/minio # Start MinIO server minio server ~/minio-data --console-address :9001Configure environment variables:
# Copy the example environment file cp .env.example .env # Edit .env with your MinIO settings MINIO_ENDPOINT=localhost MINIO_PORT=9000 MINIO_USE_SSL=false MINIO_ACCESS_KEY=minioadmin MINIO_SECRET_KEY=minioadmin MINIO_BUCKET_NAME=mcp-echarts
🔨 Development
Install dependencies:
npm install
Build the server:
npm run build
Start the MCP server:
npm run start
🧑🏻💻 Contributors
susuperli: Use
MinIOto save the chart image base64 and return the url. #10Meet-student: Add
outputTypeschema for all chart tools. #24hustcc: 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
- 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 -19MIT 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 -345MIT 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 -