
How to add MCP ECharts to Claude Desktop
Generate Apache ECharts charts locally from AI for chart generation and data analysis. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 14, 2026 ยท 242โ ยท stdio ยท no auth
Claude Desktop config for MCP ECharts
npx -y mcp-echarts{
"mcpServers": {
"mcp-echarts": {
"command": "npx",
"args": [
"-y",
"mcp-echarts"
]
}
}
}Setup steps
- 1Open Claude Desktop โ Settings โ Developer โ Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the MCP ECharts config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm MCP ECharts's tools appear under the ๐ tools menu.
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 Claude Desktop
generate_echartsGenerate visual charts using Apache ECharts with an echarts option and configuration dynamically.
generate_area_chartGenerate an area chart to show data trends under continuous independent variables and observe the overall data trend.
generate_line_chartGenerate a line chart to show trends over time.
generate_bar_chartGenerate a bar chart to show data for numerical comparisons among different categories.
generate_pie_chartGenerate a pie chart to show the proportion of parts, such as market share and budget allocation.
generate_radar_chartGenerate a radar chart to display multidimensional data (four dimensions or more).
generate_scatter_chartGenerate a scatter chart to show the relationship between two variables.
generate_sankey_chartGenerate 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 + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the MCP ECharts config there under the "mcpServers" key and restart the client.
Is MCP ECharts safe to use with Claude Desktop?
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).