# Echarts Mcp

> Apache ECharts MCP Server

- **Type:** MCP server
- **Install:** `agentstack add mcp-apache-echarts-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [apache](https://agentstack.voostack.com/s/apache)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [apache](https://github.com/apache)
- **Source:** https://github.com/apache/echarts-mcp
- **Website:** https://github.com/apache/echarts-mcp

## Install

```sh
agentstack add mcp-apache-echarts-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ECharts MCP

This project shows how to implement an MCP (Model Context Protocol) server of Apache ECharts.

The basic workflow is that it gets chart type, data and other parameters from an LLM, and returns the cloud image URL of the generated ECharts chart.

Supported ECharts series types: `'bar', 'line', 'pie', 'scatter', 'funnel', 'tree', 'treemap', 'sunburst'`.

## Setup

```sh
npm install
```

Create an `.env` file. See `.env.example` for reference. You need to have the access to a [baidubce/bce-sdk-js](https://github.com/baidubce/bce-sdk-js) account to store the images on the cloud.

## Run

```sh
# Run the MCP server
npm run dev

# Run the inspector in another terminal
npm run inspect
```

## FAQ

### How to change image cloud storage?

By default, it uses [baidubce/bce-sdk-js](https://github.com/baidubce/bce-sdk-js) to store the generated image and return the URL of the image on the cloud. If you wish to use other Cloud storage, change the implemenation in `src/storage.js`.

### How to change ECharts theme?

See `registerTheme` and `registerFont` comments in `src/chart.js`.

### How to support more series types?

1. Change `inputSchema` in `src/index.js`
2. Normalize `data` in `src/chart.js`

You are welcomed to make a pull request.

## Discussion of Implementation

To make an MCP server of Apache ECharts, there are 3 common ways to do:

1. Ask LLM to provide a full ECharts option
2. Ask LLM to provide pre-fined parameters including chart themes
3. Ask LLM to provide pre-fined minimal parameters

The advantage of Approach 1 is that is has the potential of making all kinds of charts that ECharts supports. But it may not be stable, especially for less frequently used chart types.

Approach 2 gives the freedom to change chart themes from prompt. For example, you may ask the LLM to `generate a chart with red bars of data ...`. But this approach requires a lot of parameters in order to support so many ECharts options. And it degenerates to approach 1 as the number of parameters grows.

Approach 3 asks LLM to provide minimal parameters like series type, data, seriesName, title, and axisName. The chart theme is defined in the app so that only the developer of this app, rather than users can change the theme. We believe this is the best way to provide stable results and so this is the approach we take in this project.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [apache](https://github.com/apache)
- **Source:** [apache/echarts-mcp](https://github.com/apache/echarts-mcp)
- **License:** Apache-2.0
- **Homepage:** https://github.com/apache/echarts-mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-apache-echarts-mcp
- Seller: https://agentstack.voostack.com/s/apache
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.