MCP Directory

How to add MCP ECharts to Windsurf

Generate Apache ECharts charts locally from AI for chart generation and data analysis. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 242★ · stdio · no auth

Windsurf config for MCP ECharts

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

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the MCP ECharts config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5MCP ECharts's tools become available to Cascade.

Before you start

  • Node.js 18 or higher
  • Optional: a MinIO or S3-compatible object storage endpoint for URL-based chart output

What MCP ECharts can do in Windsurf

generate_echarts

Generate visual charts using Apache ECharts with an echarts option and configuration dynamically.

generate_area_chart

Generate an area chart to show data trends under continuous independent variables and observe the overall data trend.

generate_line_chart

Generate a line chart to show trends over time.

generate_bar_chart

Generate a bar chart to show data for numerical comparisons among different categories.

generate_pie_chart

Generate a pie chart to show the proportion of parts, such as market share and budget allocation.

generate_radar_chart

Generate a radar chart to display multidimensional data (four dimensions or more).

generate_scatter_chart

Generate a scatter chart to show the relationship between two variables.

generate_sankey_chart

Generate a sankey chart to visualize flow and quantities between nodes.

Security

Charts are generated fully locally without relying on any remote service. Optional MinIO/S3-compatible object storage can be configured via environment variables (e.g. MINIO_ACCESS_KEY, MINIO_SECRET_KEY) to store and serve chart images as URLs; without it, output falls back to Base64.

MCP ECharts + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the MCP ECharts config there under the "mcpServers" key and restart the client.

Is MCP ECharts safe to use with Windsurf?

Charts are generated fully locally without relying on any remote service. Optional MinIO/S3-compatible object storage can be configured via environment variables (e.g. MINIO_ACCESS_KEY, MINIO_SECRET_KEY) to store and serve chart images as URLs; without it, output falls back to Base64.

Does it require any remote service or API key?

No. Charts are generated fully locally and the MCP server itself needs no API key. MinIO/S3 storage is optional and configured via environment variables.

What output formats are supported?

png, svg, and the ECharts option object, with validation to help the model output correct ECharts syntax across multiple rounds.

What transports are supported?

stdio (default), plus SSE and Streamable HTTP. Run with `mcp-echarts -t sse` or `-t streamable` (default port 3033).

View repo Full MCP ECharts page