← Back to directory
M

MCP ECharts

Community
Generate visual charts using ECharts with AI MCP dynamically for chart generation and data analysis.
GitHub source repository ↗
★ 262 Stars Category · Other Popular Source revision 5a4c1ccf6597
65FMRS · C
Reliability
8/20
Security and permissions
10/20
Maintenance
17/20
Documentation
15/20
Setup experience
15/20

MCP ECharts is a powerful MCP server that generates charts based on Apache ECharts, supporting multiple output formats and storage options. It is easy to install, zero-dependency, and fully local, making it suitable for data analysis and AI-driven chart generation. However, performance is limited by local resources, and it requires a Node.js environment.

Read the FMRS scoring method →

This is an MCP server that dynamically generates Apache ECharts charts using AI. It supports all features and syntax of ECharts, including data, style, theme, etc. It can export to PNG, SVG, and option formats, and provides ECharts validation to facilitate the model's multi-round output of correct syntax and graphics. It integrates with MinIO object storage to store charts as URLs instead of Base64 data for better performance and sharing capabilities. It is lightweight, zero-dependency, and fully generated locally without relying on any remote services.

Tools

echarts_generate_chart
Generates an ECharts chart based on provided options, outputting in PNG, SVG, or option format.
validate_chart_option
Validates the ECharts configuration object for correctness.

Setup

  1. Ensure Node.js 18 or higher.
  2. Add the following configuration to your client's MCP config file:
{
  "mcpServers": {
    "mcp-echarts": {
      "command": "npx",
      "args": ["-y", "mcp-echarts"]
    }
  }
}

For Windows, use cmd /c npx -y mcp-echarts.

  1. For SSE or streamable transport, install globally: npm install -g mcp-echarts, then run mcp-echarts -t sse or mcp-echarts -t streamable.
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-echarts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-echarts"
      ]
    }
  }
}

Fit and risk

Best for

  • Data analysts, developers, and AI application builders who need quick chart generation.
  • Users who want to integrate chart generation into LLM workflows.
  • Users needing charts exported in multiple formats.

Not for

  • Users needing complex interactive charts or real-time data updates.
  • Enterprise users requiring extensive chart storage and management (may need additional MinIO setup).
  • Users wanting fully managed chart hosting (since it generates locally, not relying on cloud services).

Required permissions

  • Access to the file system to read config and output files.
  • Access to MinIO service if configured.
  • Network access to install npm packages (if run via npx).

Risks and side effects

  • Since generation is fully local, performance may be limited by local resources.
  • If MinIO is not configured, exported charts are returned as Base64, which may be large and affect response speed.
  • Depends on Node.js environment; ensure version compatibility.

Troubleshooting

  1. Common issues: - Ensure Node.js version >= 18. - If `npx` fails, check npm installation. - For SSE or streamable, check if port is in use (default 3033). - If MinIO is configured, verify environment variables; otherwise, it falls back to Base64.

Use cases

Generate visual charts from natural language without manual coding.
Quickly create charts in data analysis workflows to support decisions.
Produce shareable chart links for collaboration.

Supported clients

Claude DesktopFull support
VSCodePartial support
ClinePartial support
Cherry StudioPartial support