VChart

v1.0.0Developer Toolsstable

A Model Context Protocol (MCP) server for the @visactor/vchart that enables AI assistants to generate interactive charts and visualizations.

vchartmcpai-integration
Share:
51
Stars
0
Downloads
0
Weekly
0/5

What is VChart?

VChart is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server for the @visactor/vchart that enables ai assistants to generate interactive charts and visualizations.

A Model Context Protocol (MCP) server for the @visactor/vchart that enables AI assistants to generate interactive charts and visualizations.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server for the @visactor/vcha

Use Cases

Generate interactive charts and visualizations for data.
Create data-driven visual outputs through MCP.
VisActor

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedApr 30, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx vchart

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use VChart

VChart MCP Server is a Model Context Protocol server built on the @visactor/vchart library that enables AI assistants to generate rich, interactive charts and data visualizations. It supports ten distinct chart families — including cartesian, polar, hierarchical, scatter, sankey, heatmap, word cloud, and more — and outputs results as PNG images, interactive HTML, or raw VChart spec objects. Developers and analysts use it to turn tabular data into production-ready charts directly from a conversation, without writing visualization code manually.

Prerequisites

  • Node.js 18 or later installed on your system
  • An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
  • npx available (bundled with Node.js via npm)
  • Internet access to reach the default VisActor image-export service at vmind.visactor.com (or a self-hosted alternative)
1

Verify Node.js is installed

The server is distributed as an npm package and runs via npx, so Node.js 18+ is required. Check your version before proceeding.

node --version
2

Open your MCP client configuration file

Claude Desktop stores its MCP server list in a JSON config file. On macOS the path is ~/Library/Application Support/Claude/claude_desktop_config.json. Open it in your editor.

3

Add the vchart-mcp-server entry

Insert the server block into the mcpServers object. On macOS and Linux use the npx form shown. On Windows wrap it in cmd /c.

{
  "mcpServers": {
    "vchart-mcp-server": {
      "command": "npx",
      "args": ["-y", "@visactor/vchart-mcp-server"]
    }
  }
}
4

(Optional) Configure a private image-export server

By default chart images are rendered via https://vmind.visactor.com/export. For air-gapped or enterprise deployments set the VIMD_IMAGE_SERVER environment variable to point to your own export endpoint.

{
  "mcpServers": {
    "vchart-mcp-server": {
      "command": "npx",
      "args": ["-y", "@visactor/vchart-mcp-server"],
      "env": {
        "VIMD_IMAGE_SERVER": "https://your-export-server/export"
      }
    }
  }
}
5

Restart Claude Desktop and verify the server loads

Close and reopen Claude Desktop. Click the MCP icon in the toolbar — vchart-mcp-server should appear with a green status indicator, exposing tools such as generate_cartesian_chart, generate_polar_chart, and generate_scatter_chart.

6

Ask Claude to generate your first chart

Paste some tabular data into the chat and ask Claude to create a chart. It will call the appropriate vchart tool and return an image inline in the conversation.

VChart Examples

Client configuration

Minimal Claude Desktop config for macOS/Linux. On Windows replace the args array with ["cmd", "/c", "npx", "-y", "@visactor/vchart-mcp-server"].

{
  "mcpServers": {
    "vchart-mcp-server": {
      "command": "npx",
      "args": ["-y", "@visactor/vchart-mcp-server"]
    }
  }
}

Prompts to try

Example prompts that exercise the different chart tools exposed by this server.

- "Create a bar chart from this sales data: [{month:'Jan',revenue:12000},{month:'Feb',revenue:15000},{month:'Mar',revenue:9500}]"
- "Generate a pie chart showing market share: Apple 52%, Samsung 28%, Others 20%"
- "Make a scatter chart of height vs weight from this dataset and output it as an HTML file"
- "Build a heatmap of weekly activity — rows are days, columns are hours, values are commits"
- "Create an animated ranking bar chart showing country GDP over the years 2000–2023"

Troubleshooting VChart

Charts fail to render and the tool returns an error about the image server

The default export endpoint is https://vmind.visactor.com/export. If your network blocks external requests, set VIMD_IMAGE_SERVER to a self-hosted VisActor export service in the env block of your config.

npx command is not found or the server fails to start

Ensure Node.js 18+ is installed and that the npm bin directory is in your PATH. Run 'node --version' and 'npx --version' in a terminal to verify, then restart Claude Desktop.

The generate_cartesian_chart tool returns a blank image

Check that your dataTable array is non-empty and that xField and yField match actual property names in the data objects. Field names are case-sensitive.

Frequently Asked Questions about VChart

What is VChart?

VChart is a Model Context Protocol (MCP) server that model context protocol (mcp) server for the @visactor/vchart that enables ai assistants to generate interactive charts and visualizations. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install VChart?

Follow the installation instructions on the VChart GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with VChart?

VChart works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is VChart free to use?

Yes, VChart is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use VChart?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides