MCP ECharts

v1.0.0Data Science & MLstable

Generates Apache ECharts diagrams and charts with AI dynamically, supporting all ECharts features and exporting to png, svg, and option formats.

echartsllmmcpmcp-server
Share:
232
Stars
0
Downloads
0
Weekly
0/5

What is MCP ECharts?

MCP ECharts is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to generates apache echarts diagrams and charts with ai dynamically, supporting all echarts features and exporting to png, svg, and option formats.

Generates Apache ECharts diagrams and charts with AI dynamically, supporting all ECharts features and exporting to png, svg, and option formats.

This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Generates Apache ECharts diagrams and charts with AI dynamic

Use Cases

Generate dynamic charts with AI
Create ECharts diagrams
Export visualizations to PNG/SVG
hustcc

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-echarts

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP ECharts

MCP ECharts is a Model Context Protocol server that lets AI assistants generate rich, interactive Apache ECharts visualizations on demand — turning natural language requests into bar charts, line graphs, pie charts, scatter plots, and more. It supports the full ECharts feature set including custom theming, data styling, and chart validation, and can export results as PNG images, SVG vector graphics, or raw ECharts JSON option objects. Front-end developers, data analysts, and AI workflow builders use it to instantly produce production-quality charts without writing JavaScript manually.

Prerequisites

  • Node.js 18 or higher installed
  • An MCP-compatible AI client such as Claude Desktop or Cursor
  • npx available in your PATH (included with Node.js via npm)
  • Optional: MinIO instance if you want cloud storage for exported chart assets
1

Verify Node.js version

MCP ECharts requires Node.js 18 or later. Check your installed version and upgrade if necessary.

node --version
2

Choose your installation method

You can run mcp-echarts directly with npx (no install needed) or install it globally with npm. For most users, npx is the simplest approach.

# Run directly without installing:
npx -y mcp-echarts

# Or install globally:
npm install -g mcp-echarts
3

Configure mcp-echarts in your MCP client

Add the mcp-echarts server to your MCP client's configuration file. The server communicates over stdio by default.

4

Optional: configure MinIO for cloud storage

If you want generated chart images stored in MinIO rather than returned inline, set the MinIO environment variables in your MCP client config.

5

Restart your MCP client and verify

Restart Claude Desktop or your MCP client to load the new server. Ask it to generate a simple chart to confirm the server is working.

MCP ECharts Examples

Client configuration

Add mcp-echarts to Claude Desktop using npx. On Windows, use cmd /c npx instead.

{
  "mcpServers": {
    "mcp-echarts": {
      "command": "npx",
      "args": ["-y", "mcp-echarts"]
    }
  }
}

Client configuration with MinIO storage

Extended configuration that persists exported chart assets to a MinIO bucket.

{
  "mcpServers": {
    "mcp-echarts": {
      "command": "npx",
      "args": ["-y", "mcp-echarts"],
      "env": {
        "MINIO_ENDPOINT": "localhost",
        "MINIO_PORT": "9000",
        "MINIO_USE_SSL": "false",
        "MINIO_ACCESS_KEY": "minioadmin",
        "MINIO_SECRET_KEY": "minioadmin",
        "MINIO_BUCKET_NAME": "mcp-echarts"
      }
    }
  }
}

Prompts to try

Once the server is connected, ask your AI assistant to generate charts using natural language.

- "Create a bar chart showing monthly sales: Jan 120, Feb 150, Mar 90, Apr 200."
- "Generate a pie chart of browser market share: Chrome 65%, Safari 19%, Firefox 4%, Edge 4%, Other 8%."
- "Make a line chart comparing CPU and memory usage over 24 hours and export it as PNG."
- "Build a scatter plot of height vs weight for a sample dataset and add a trend line."
- "Create a stacked bar chart of quarterly revenue by region and return it as SVG."

Troubleshooting MCP ECharts

npx fails with 'engine not supported' or version errors

Upgrade Node.js to version 18 or later. Use nvm (Node Version Manager) to switch versions: 'nvm install 18 && nvm use 18', then restart your MCP client.

Chart is generated but the image is blank or corrupted

This can happen if the ECharts option JSON produced by the AI contains syntax errors. Ask the AI to validate the ECharts configuration first, or request the 'option' format instead of PNG to inspect the raw config.

MinIO storage configuration is not working

Confirm your MinIO instance is running and the bucket specified in MINIO_BUCKET_NAME exists. Test connectivity with the MinIO client (mc) before adding the credentials to the MCP config.

Frequently Asked Questions about MCP ECharts

What is MCP ECharts?

MCP ECharts is a Model Context Protocol (MCP) server that generates apache echarts diagrams and charts with ai dynamically, supporting all echarts features and exporting to png, svg, and option formats. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP ECharts?

Follow the installation instructions on the MCP ECharts GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP ECharts?

MCP ECharts works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP ECharts free to use?

Yes, MCP ECharts is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Data Science & ML MCP Servers

Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-echarts": { "command": "npx", "args": ["-y", "mcp-echarts"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP ECharts?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides