Log inSubmit server
Search2chart MCP logo

Search2chart MCP

Turns tabular data or CSV/XLSX files into ECharts HTML and inline chart outputs for MCP clients.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Search2chart MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "search2chart-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "search2chart-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y search2chart-mcp

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked Today.

Overview

search2chart-mcp MCP server converts tabular data and CSV/XLSX files into ECharts visualizations through MCP tools. It returns self-contained interactive HTML files and can provide charts as data URIs, local files, localhost URLs, CDN URLs, or MCP image blocks. Use it when an agent needs to visualize structured data inside a supported client conversation or open the result in a browser. The server also preserves source data in tool results for follow-up analysis unless that option is disabled.

Use cases

  • Create charts from tables in an agent conversation
  • Visualize CSV or XLSX files
  • Open generated charts as interactive HTML
  • Test image rendering formats across MCP clients

Key features

  • Generate ECharts charts from structured data
  • Read CSV and XLSX file paths
  • Return inline images in multiple formats
  • Write self-contained interactive HTML
  • List chart types and field conventions
  • Preserve source data for follow-up analysis

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

5/5 checks healthy over the last 42d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · search2chart-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads188Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Search2chart MCP works

What search2chart-mcp MCP server does

The search2chart-mcp MCP server turns structured tabular data into ECharts-based visualizations. It can work from data supplied directly in a tool call or from CSV and XLSX file paths. Each chart is also written as an HTML file that can be opened in a browser and used interactively.

The expected table layout is simple: the first column supplies category labels, while later columns represent numeric series. Multiple numeric columns produce multiple series. The available chart types, color options, and field conventions can be checked through a separate tool.

How it works

The MCP implementation communicates over standard input and output. An MCP client launches the server, then an agent calls one of the chart tools with data, a file path, a title, and chart options as needed. The response includes chart output and can also include the complete source data as JSON, allowing a text-only model to continue calculations such as comparisons, proportions, or trend analysis.

Inline output is controlled with ECHARTS_INLINE_MODE. The default inline mode tries a data URI and can fall back to a localhost URL or a local file. file returns a file:// path, cdn returns a public HTTPS address through GitHub and jsDelivr, all returns several formats for compatibility testing, and none provides text output with the HTML path and data.

Setup and configuration

The search2chart-mcp MCP server can be started with npx search2chart-mcp, so cloning the repository is not required. A typical MCP configuration sets command to npx and passes search2chart-mcp as its argument. A cloned checkout can instead be launched with Node and the absolute path to mcp/server.js.

After installation, test rendering with ECHARTS_INLINE_MODE=all. Ask the agent to create a small chart and identify which returned format is displayed correctly. Then set a fixed mode that matches the client. The README reports tested behavior for several clients, including file output for ZCode, data URI output for OpenCode, CDN output for WorkBuddy, localhost output for DSH, and MCP image blocks with returnImage: true for Claude and Cursor.

A native DSH plugin is also provided separately. DSH users can choose that plugin for native inline images, while the general MCP implementation remains available and can return file links.

Tools and capabilities

  • chart_from_data creates a chart from structured data.
  • chart_from_file reads a CSV or XLSX path and creates a chart.
  • list_chart_types lists supported chart types, colors, and field rules.
  • Interactive HTML supports hover, zooming, chart-type changes, and color adjustments.
  • Optional CDN output rasterizes SVG to PNG and uploads through GitHub Contents API before serving it through jsDelivr.
  • returnData: false disables inclusion of the original data in results.

Limitations and notes

The rendered result depends on the image and file formats accepted by the MCP client. The all mode is intended to identify a format that the client can display; it is not necessarily the best permanent setting. If no inline format renders, none leaves an HTML file for browser use instead.

CDN mode requires the GitHub-based upload path described by the project and exposes the resulting image through a public URL. The repository describes automated cleanup with a default three-day retention period. The search2chart-mcp MCP server does not replace the client’s renderer, so clients with different support for data URIs, local paths, HTTP URLs, or MCP image blocks may need different modes.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Search2chart MCP

search2chart-mcp is an MCP server that connects AI agents to tabular data supplied directly or through CSV/XLSX file paths and generates ECharts visualizations. Its main tools are chart_from_data, chart_from_file, and list_chart_types, returning HTML, inline image formats, and chart-type guidance.

Install it by configuring an MCP client to run `npx search2chart-mcp`. You can also clone the repository and launch `mcp/server.js` with Node using its absolute path. A native DSH plugin is available separately for DeepSeek Harness users.

Set `ECHARTS_INLINE_MODE` to a format supported by the client. Start with `all` to compare data URI, localhost, file, and CDN results, then use `inline`, `file`, `cdn`, or `none` as appropriate. Claude and Cursor can also use `returnImage: true` with inline mode.

Yes, search2chart-mcp works with Cursor through its general MCP server configuration. The README specifically reports Cursor support for inline mode with `returnImage: true`, allowing the tool to return an MCP image block when the client supports it.

Related MCP servers

All in Data Visualization All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSearch2chart MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/search2chart-mcp?style=directory)](https://allmcps.com/mcp/search2chart-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/search2chart-mcp"><img src="https://allmcps.com/api/badge/search2chart-mcp?style=directory" alt="Search2chart MCP on AllMCPs" /></a>