Log inSubmit server
MCP Echarts logo

MCP Echarts

by hustcc

Generate Apache ECharts visualizations through MCP using predefined chart tools or custom ECharts options.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Echarts

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hustcc-mcp-echarts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-echarts"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

hustcc/mcp-echarts MCP server generates Apache ECharts visualizations from AI requests and chart configuration. It exposes a general ECharts tool alongside specialized tools for common chart types, including line, bar, pie, flow, hierarchical, statistical, and financial charts. Results can be exported as PNG, SVG, or ECharts option data, with optional MinIO storage for URL-based image output. Use it when an MCP client needs locally generated charts or structured visualization output.

Use cases

  • Generate a line chart from time-series data
  • Compare categories with a bar or radar chart
  • Visualize conversion stages with a funnel chart
  • Render hierarchical data with a treemap or tree chart
  • Export chart images or ECharts options for an application

Key features

  • Custom Apache ECharts option generation
  • Specialized tools for 18 chart types
  • PNG, SVG, and option output
  • ECharts syntax and output validation
  • Optional MinIO-compatible URL storage
  • stdio, SSE, and streamable transports

Tools18

What MCP Echarts lets your agent do. Expand a tool for its parameters.

Verified live~9.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

20/20 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 1

Scanned 11d ago via OSV.dev · mcp-echarts (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars270Stargazers on the source repository.
npm downloads2.7kPackage downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Tools exposed18Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Echarts works

What hustcc/mcp-echarts MCP server does

The hustcc/mcp-echarts MCP server turns chart requests and ECharts configuration into visualizations through the Model Context Protocol. It is built around Apache ECharts and supports both a general-purpose generation tool and separate tools for frequently used chart families.

The general generate_echarts tool accepts ECharts options and configuration for custom visualizations. Specialized tools cover area, line, bar, pie, radar, scatter, Sankey, funnel, gauge, treemap, sunburst, heatmap, candlestick, boxplot, graph, parallel coordinates, and tree charts. These tools map common analytical needs to chart-specific generation requests, such as showing category comparisons, proportions, flows, hierarchies, distributions, or relationships.

How it works

An MCP-compatible client starts the package locally over standard input/output, or connects to an HTTP endpoint when the server is run with SSE or streamable transport. The server renders the requested Apache ECharts result and can return one of three output forms: a PNG image, an SVG image, or the ECharts option representation.

Generated output is validated for ECharts compatibility. This supports iterative requests in which an AI model adjusts chart syntax or presentation based on earlier results. Rendering occurs locally rather than through a required remote visualization service.

Setup and configuration

Node.js 18 or newer is required. For a desktop client using stdio, the package can be launched with npx -y mcp-echarts. The README provides configurations for macOS-style command execution and Windows through cmd. Claude Desktop, VS Code, and Cline are named as example desktop applications, alongside other compatible desktop clients.

For HTTP-style access, install the package globally with npm install -g mcp-echarts. Run mcp-echarts -t sse for SSE, which defaults to port 3033 and the /sse endpoint, or use mcp-echarts -t streamable, which defaults to /mcp. The port and endpoint can be changed with the CLI options -p and -e; -t stdio selects standard input/output.

MinIO configuration is optional. When configured, chart images can be stored in object storage and returned as URLs instead of Base64 data. Supported object-storage approaches include MinIO and S3-compatible or cloud storage services such as Amazon S3, Alibaba Cloud OSS, Google Cloud Storage, Microsoft Azure Blob Storage, and Tencent Cloud COS. If storage is unavailable or not configured, the server falls back to Base64 output.

Tools and capabilities

The hustcc/mcp-echarts MCP server provides:

  • Custom ECharts generation through generate_echarts.
  • Area, line, bar, pie, radar, and scatter charts.
  • Sankey, funnel, gauge, treemap, and sunburst charts.
  • Heatmap, candlestick, boxplot, graph, parallel coordinates, and tree charts.
  • PNG, SVG, and option output formats.
  • ECharts option validation and optional object-storage URLs.

Limitations and notes

The package requires Node.js 18 or later. MinIO or another object-storage setup is not necessary for basic use, but URL-based image output depends on configuring storage. Without it, image results use Base64 data.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Echarts

hustcc/mcp-echarts is an MCP server that connects AI clients to Apache ECharts for local chart generation. Its main tools include generate_echarts plus specialized tools for line, bar, pie, area, scatter, flow, hierarchy, statistical, and financial charts, with PNG, SVG, or option output.

Install it by running `npx -y mcp-echarts` from an MCP client configuration, or install it globally with `npm install -g mcp-echarts` for SSE or streamable transport. Node.js 18 or newer is required.

Configure the client to launch `npx` with `-y` and `mcp-echarts`; the provided setup includes a macOS command form and a Windows `cmd` form.

Run `mcp-echarts -t sse` for SSE or `mcp-echarts -t streamable` for streamable transport. The default port is 3033; the default endpoints are `/sse` and `/mcp`, respectively. Use `-p` and `-e` to change the port or endpoint.

Yes, it can return image URLs when MinIO or a supported object-storage configuration is available. Without storage configuration or when storage is unavailable, the server falls back to Base64 image data.

Related MCP servers

All in Customer Data Platforms All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Echarts AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/hustcc-mcp-echarts?style=directory)](https://allmcps.com/mcp/hustcc-mcp-echarts)
HTML Embed
<a href="https://allmcps.com/mcp/hustcc-mcp-echarts"><img src="https://allmcps.com/api/badge/hustcc-mcp-echarts?style=directory" alt="MCP Echarts on AllMCPs" /></a>