# hustcc/mcp-echarts [Health: Active] **Category:** 👤 Customer Data Platforms **Repository:** https://github.com/hustcc/mcp-echarts **GitHub Stars:** 266 **npm Downloads (last month):** 1174 **Views:** 1 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/hustcc-mcp-echarts ## Description Generate visual charts using Apache ECharts with AI MCP dynamically. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "mcp-echarts": { "command": "npx", "args": ["-y","mcp-echarts"], "env": { "MINIO_ENDPOINT": "", "MINIO_PORT": "", "MINIO_USE_SSL": "", "MINIO_ACCESS_KEY": "", "MINIO_SECRET_KEY": "", "MINIO_BUCKET_NAME": "" } } } ``` **Requires environment variables:** `MINIO_ENDPOINT`, `MINIO_PORT`, `MINIO_USE_SSL`, `MINIO_ACCESS_KEY`, `MINIO_SECRET_KEY`, `MINIO_BUCKET_NAME` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for). ## Documentation & README # MCP ECharts ![](https://badge.mcpx.dev?type=server 'MCP Server') [![build](https://github.com/hustcc/mcp-echarts/actions/workflows/build.yml/badge.svg)](https://github.com/hustcc/mcp-echarts/actions/workflows/build.yml) [![npm Version](https://img.shields.io/npm/v/mcp-echarts.svg)](https://www.npmjs.com/package/mcp-echarts) [![Listed on Skillselion](https://skillselion.com/badge/mcp/tool/io.github.hustcc/mcp-echarts.svg)](https://skillselion.com/mcp/tool/io.github.hustcc/mcp-echarts) [![npm License](https://img.shields.io/npm/l/mcp-echarts.svg)](https://www.npmjs.com/package/mcp-echarts) [![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/hustcc/mcp-echarts)](https://archestra.ai/mcp-catalog/hustcc__mcp-echarts) Generate [Apache ECharts](https://echarts.apache.org/) with AI MCP dynamically for chart generation and data analysis. _Also you can use [mcp-server-chart](https://github.com/antvis/mcp-server-chart) to generate chart, graph, map._
mcp-echarts
award
## ✨ Features - Fully support all features and syntax of `ECharts`, include data, style, theme and so on. - Support exporting to `png`, `svg`, and `option` formats, with validation for `ECharts` to facilitate the model's multi-round output of correct syntax and graphics. - MinIO Integration, store charts in `MinIO` object storage and return URLs instead of Base64 data for better performance and sharing capabilities. - Lightweight, we can install it easily with `zero dependence`. - Extremely `secure`, fully generated locally, without relying on any remote services. ## 🤖 Usage ### Prerequisites - Node.js 18 or higher is required. ### Desktop Applications (stdio transport) To use with `Desktop APP`, such as Claude, VSCode, Cline, Cherry Studio, and so on, add the MCP server config below. On Mac system: ```json { "mcpServers": { "mcp-echarts": { "command": "npx", "args": [ "-y", "mcp-echarts" ] } } } ``` On Window system: ```json { "mcpServers": { "mcp-echarts": { "command": "cmd", "args": [ "/c", "npx", "-y", "mcp-echarts" ] } } } ``` Also, you can use it on [modelscope](https://www.modelscope.cn/mcp/servers/hustcc/MCP-ECharts), [glama.ai](https://glama.ai/mcp/servers/@hustcc/mcp-echarts), [skillselion.com](https://skillselion.com/mcp/tool/io.github.hustcc/mcp-echarts) or others with HTTP, SSE Protocol. ## 🚰 Run with SSE or Streamable transport Install the package globally. ```bash npm install -g mcp-echarts ``` Run the server with your preferred transport option: ```bash # For SSE transport (default endpoint: /sse) mcp-echarts -t sse # For Streamable transport with custom endpoint mcp-echarts -t streamable ``` Then you can access the server at: - SSE transport: `http://localhost:3033/sse` - Streamable transport: `http://localhost:3033/mcp` ## 🎮 CLI Options You can also use the following CLI options when running the MCP server. Command options by run cli with `-h`. ```plain MCP ECharts CLI Options: --transport, -t Specify the transport protocol: "stdio", "sse", or "streamable" (default: "stdio") --port, -p Specify the port for SSE or streamable transport (default: 3033) --endpoint, -e Specify the endpoint for the transport: - For SSE: default is "/sse" - For streamable: default is "/mcp" --help, -h Show this help message ``` ## 🗂️ MinIO Configuration (Optional) For better performance and sharing capabilities, you can configure MinIO object storage to store chart images as URLs instead of Base64 data. > [!NOTE] > If MinIO is not configured or unavailable, the system automatically falls back to `Base64` data output, ensuring compatibility. We can Integrate with `MinIO` object storage providers below. - [MinIO](https://min.io/): High-performance, S3-compatible object storage. Use [MinIO JavaScript Client](https://docs.min.io/enterprise/aistor-object-store/developers/sdk/javascript/) for direct integration. - [Amazon S3](https://aws.amazon.com/s3/): Use [AWS SDK](https://aws.amazon.com/sdk-for-javascript/) with compatible API endpoint. - [Alibaba Cloud OSS](https://www.alibabacloud.com/product/object-storage-service): Use the [Alibaba Cloud SDK](https://www.alibabacloud.com/help/en/sdk) for OSS services. - [Google Cloud Storage](https://cloud.google.com/storage): Integrate using [Google Cloud SDK](https://cloud.google.com/sdk) or compatible API. - [Microsoft Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs): Use [Azure SDK](https://azure.microsoft.com/en-us/downloads/) for Blob storage access. - [Tencent Cloud COS](https://intl.cloud.tencent.com/product/cos): Use the [Tencent Cloud SDK](https://intl.cloud.tencent.com/document/product/436/6474) for COS integration. Also, we can setup MinIO locally for free. 1. **Install and start MinIO locally:** ```bash # Download MinIO (macOS example) brew install minio/stable/minio # Start MinIO server minio server ~/minio-data --console-address :9001 ``` 3. **Configure environment variables:** ```bash # Copy the example environment file cp .env.example .env # Edit .env with your MinIO settings MINIO_ENDPOINT=localhost MINIO_PORT=9000 MINIO_USE_SSL=false MINIO_ACCESS_KEY=minioadmin MINIO_SECRET_KEY=minioadmin MINIO_BUCKET_NAME=mcp-echarts ``` ## 🔨 Development Install dependencies: ```bash npm install ``` Build the server: ```bash npm run build ``` Start the MCP server: ```bash npm run start ``` ## 🧑🏻‍💻 Contributors - [lyw405](https://github.com/lyw405): Supports `15+` charting MCP tool. [#2](https://github.com/hustcc/mcp-echarts/issues/2) - [2niuhe](https://github.com/2niuhe): Support MCP with SSE and Streaming HTTP. [#17](https://github.com/hustcc/mcp-echarts/issues/17) - [susuperli](https://github.com/susuperli): Use `MinIO` to save the chart image base64 and return the url. [#10](https://github.com/hustcc/mcp-echarts/issues/10) - [BQXBQX](https://github.com/BQXBQX): Use `@napi-rs/canvas` instead node-canvas. [#3](https://github.com/hustcc/mcp-echarts/issues/3) - [Meet-student](https://github.com/Meet-student): Add `outputType` schema for all chart tools. [#24](https://github.com/hustcc/mcp-echarts/issues/24) - [hustcc](https://github.com/hustcc): Initial the repo. ## 📄 License MIT@[hustcc](https://github.com/hustcc).