Generates 25+ chart types and pivot tables from data supplied by an AI client for analysis and visualization.
Also known as antvis/mcp-server-chart, @antv/mcp-server-chart
- Stars
- 4,418
- Tools
- 25
- Downloads, 30 days
- 38,285
- Latest version
- 1.0.0
- Last commit
- Aug 27, 2026
- License
- MIT
What is AntV Chart MCP?
AntV Chart generates 25+ chart types and pivot tables from data supplied by an AI client for analysis and visualization. It exposes 25 tools, such as generate_area_chart, generate_bar_chart, generate_boxplot_chart.
Summary generated from the project's README
About AntV Chart MCP server
Visualizing complex datasets through diverse graphical formats is what mcp-server-chart enables for developers and data analysts. By connecting this TypeScript-based server to AI clients like Claude, VSCode, Cursor, or Cline, users can transform raw data into over 25 distinct visual representations. The server supports a wide array of specialized tools including line charts, treemaps, sankey diagrams, and even mind maps to represent hierarchical information.
Setup is straightforward using npx for local desktop applications or via Docker for containerized environments. The server supports multiple transport protocols including stdio, SSE, and streamable options. While it provides a free generation service by default, developers can implement private deployments by configuring the VIS_REQUEST_SERVER environment variable. Geographic visualizations like district maps and pin maps utilize the AMap service and are currently limited to map generation within China.
Written from the project's README. Every use case is checked against a quote from it.
How to install AntV Chart MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AntV Chart MCP in Claude Code
$ claude mcp add --env 'SERVICE_ID=<YOUR_SERVICE_ID>' mcp-server-chart -- npx -y @antv/mcp-server-chartInstall AntV Chart MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": [
"-y",
"@antv/mcp-server-chart"
],
"env": {
"SERVICE_ID": "<YOUR_SERVICE_ID>"
}
}
}
}Install AntV Chart MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server-chart": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@antv/mcp-server-chart"
],
"env": {
"SERVICE_ID": "<YOUR_SERVICE_ID>"
}
}
}
}Install AntV Chart MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server-chart","type":"stdio","command":"npx","args":["-y","@antv/mcp-server-chart"],"env":{"SERVICE_ID":"<YOUR_SERVICE_ID>"}}'Install AntV Chart MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": [
"-y",
"@antv/mcp-server-chart"
],
"env": {
"SERVICE_ID": "<YOUR_SERVICE_ID>"
}
}
}
}Install AntV Chart MCP in Codex
$ codex mcp add mcp-server-chart --env 'SERVICE_ID=<YOUR_SERVICE_ID>' -- npx -y @antv/mcp-server-chartInstall AntV Chart MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server-chart] command = "npx" args = ["-y", "@antv/mcp-server-chart"] [mcp_servers.mcp-server-chart.env] SERVICE_ID = "<YOUR_SERVICE_ID>"
Install AntV Chart MCP in Gemini CLI
$ gemini mcp add -s user -e 'SERVICE_ID=<YOUR_SERVICE_ID>' mcp-server-chart npx -- -y @antv/mcp-server-chartInstall AntV Chart MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": [
"-y",
"@antv/mcp-server-chart"
],
"env": {
"SERVICE_ID": "<YOUR_SERVICE_ID>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @antv/mcp-server-chart 0.9.0-beta.1 in an isolated container with no network and no keys. It answered and listed 25 tools.
AntV Chart MCP tools 25
Read from the server with tools/listgenerate_area_chartGenerate a area chart to show data trends under continuous independent variables and observe the overall data trend, such as, displacement = velocity (average or instantaneous) × time: s = v × t. If the x-axis is time (t) and the y-axis is velocity (v) at each moment, an area chart allows you to observe the trend of velocity over time and infer the distance traveled by the area's size.
generate_bar_chartGenerate a horizontal bar chart to show data for numerical comparisons among different categories, such as, comparing categorical data and for horizontal comparisons.
generate_boxplot_chartGenerate a boxplot chart to show data for statistical summaries among different categories, such as, comparing the distribution of data points across categories.
generate_column_chartGenerate a column chart, which are best for comparing categorical data, such as, when values are close, column charts are preferable because our eyes are better at judging height than other visual elements like area or angles.
generate_district_mapGenerates regional distribution maps, which are usually used to show the administrative divisions and coverage of a dataset. It is not suitable for showing the distribution of specific locations, such as urban administrative divisions, GDP distribution maps of provinces and cities across the country, etc. This tool is limited to generating data maps within China.
generate_dual_axes_chartGenerate a dual axes chart which is a combination chart that integrates two different chart types, typically combining a bar chart with a line chart to display both the trend and comparison of data, such as, the trend of sales and profit over time.
generate_fishbone_diagramGenerate a fishbone diagram chart to uses a fish skeleton, like structure to display the causes or effects of a core problem, with the problem as the fish head and the causes/effects as the fish bones. It suits problems that can be split into multiple related factors.
generate_flow_diagramGenerate a flow diagram chart to show the steps and decision points of a process or system, such as, scenarios requiring linear process presentation.
generate_funnel_chartGenerate a funnel chart to visualize the progressive reduction of data as it passes through stages, such as, the conversion rates of users from visiting a website to completing a purchase.
generate_histogram_chartGenerate a histogram chart to show the frequency of data points within a certain range. It can observe data distribution, such as, normal and skewed distributions, and identify data concentration areas and extreme points.
generate_line_chartGenerate a line chart to show trends over time, such as, the ratio of Apple computer sales to Apple's profits changed from 2000 to 2016.
generate_liquid_chartGenerate a liquid chart to visualize a single value as a percentage, such as, the current occupancy rate of a reservoir or the completion percentage of a project.
Show all 25 toolsShow fewer tools
generate_mind_mapGenerate a mind map chart to organizes and presents information in a hierarchical structure with branches radiating from a central topic, such as, a diagram showing the relationship between a main topic and its subtopics.
generate_network_graphGenerate a network graph chart to show relationships (edges) between entities (nodes), such as, relationships between people in social networks.
generate_organization_chartGenerate an organization chart to visualize the hierarchical structure of an organization, such as, a diagram showing the relationship between a CEO and their direct reports.
generate_path_mapGenerate a route map to display the user's planned route, such as travel guide routes.
generate_pie_chartGenerate a pie chart to show the proportion of parts, such as, market share and budget allocation.
generate_pin_mapGenerate a point map to display the location and distribution of point data on the map, such as the location distribution of attractions, hospitals, supermarkets, etc.
generate_radar_chartGenerate a radar chart to display multidimensional data (four dimensions or more), such as, evaluate Huawei and Apple phones in terms of five dimensions: ease of use, functionality, camera, benchmark scores, and battery life.
generate_sankey_chartGenerate a sankey chart to visualize the flow of data between different stages or categories, such as, the user journey from landing on a page to completing a purchase.
generate_scatter_chartGenerate a scatter chart to show the relationship between two variables, helps discover their relationship or trends, such as, the strength of correlation, data distribution patterns.
generate_treemap_chartGenerate a treemap chart to display hierarchical data and can intuitively show comparisons between items at the same level, such as, show disk space usage with treemap.
generate_venn_chartGenerate a Venn diagram to visualize the relationships between different sets, showing how they intersect and overlap, such as the commonalities and differences between various groups.
generate_violin_chartGenerate a violin chart to show data for statistical summaries among different categories, such as, comparing the distribution of data points across categories.
generate_word_cloud_chartGenerate a word cloud chart to show word frequency or weight through text size variation, such as, analyzing common words in social media, reviews, or feedback.
Configuration
SERVICE_IDSecretService identifier for chart generation records
DISABLED_TOOLSDISABLED_TOOLSComma-separated list of tool names to disable
SERVICE_IDVIS_REQUEST_SERVERVIS_REQUEST_SERVERCustom chart generation service URL for private deployment
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableantvis/mcp-server-chart is public and reachablegithub.com/antvis/mcp-server-chart ↗Pass
- Package names this repository as its source@antv/mcp-server-chart names antvis/mcp-server-chart as sourcenpmjs.com/package/@antv/mcp-server-chart ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-27github.com/antvis/mcp-server-chart ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @antv/mcp-server-chartPass
- No critical advisory in the package or its dependencies112 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model25 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubMCP Server Chart
A Model Context Protocol server for generating charts using AntV. We can use this mcp server for chart generation and data analysis.
This is a TypeScript-based MCP server that provides chart generation capabilities. It allows you to create various types of charts through MCP tools. You can also use it in Dify.
📋 Table of Contents
- ✨ Features
- 🤖 Usage
- 🎨 Skill Usage
- 🚰 Run with SSE or Streamable transport
- 🎮 CLI Options
- ⚙️ Environment Variables
- 📠 Private Deployment
- 🗺️ Generate Records
- 🎛️ Tool Filtering
- 🔨 Development
- 📄 License
✨ Features
Now 26+ charts supported.
generate_area_chart: Generate anareachart, used to display the trend of data under a continuous independent variable, allowing observation of overall data trends.generate_bar_chart: Generate abarchart, used to compare values across different categories, suitable for horizontal comparisons.generate_boxplot_chart: Generate aboxplot, used to display the distribution of data, including the median, quartiles, and outliers.generate_column_chart: Generate acolumnchart, used to compare values across different categories, suitable for vertical comparisons.generate_district_map- Generate adistrict-map, used to show administrative divisions and data distribution.generate_dual_axes_chart: Generate adual-axeschart, used to display the relationship between two variables with different units or ranges.generate_fishbone_diagram: Generate afishbonediagram, also known as an Ishikawa diagram, used to identify and display the root causes of a problem.generate_flow_diagram: Generate aflowchart, used to display the steps and sequence of a process.generate_funnel_chart: Generate afunnelchart, used to display data loss at different stages.generate_histogram_chart: Generate ahistogram, used to display the distribution of data by dividing it into intervals and counting the number of data points in each interval.generate_line_chart: Generate alinechart, used to display the trend of data over time or another continuous variable.generate_liquid_chart: Generate aliquidchart, used to display the proportion of data, visually representing percentages in the form of water-filled spheres.generate_mind_map: Generate amind-map, used to display thought processes and hierarchical information.generate_network_graph: Generate anetworkgraph, used to display relationships and connections between nodes.generate_organization_chart: Generate anorganizationalchart, used to display the structure of an organization and personnel relationships.generate_path_map- Generate apath-map, used to display route planning results for POIs.generate_pie_chart: Generate apiechart, used to display the proportion of data, dividing it into parts represented by sectors showing the percentage of each part.generate_pin_map- Generate apin-map, used to show the distribution of POIs.generate_radar_chart: Generate aradarchart, used to display multi-dimensional data comprehensively, showing multiple dimensions in a radar-like format.generate_sankey_chart: Generate asankeychart, used to display data flow and volume, representing the movement of data between different nodes in a Sankey-style format.generate_scatter_chart: Generate ascatterplot, used to display the relationship between two variables, showing data points as scattered dots on a coordinate system.generate_treemap_chart: Generate atreemap, used to display hierarchical data, showing data in rectangular forms where the size of rectangles represents the value of the data.generate_venn_chart: Generate avenndiagram, used to display relationships between sets, including intersections, unions, and differences.generate_violin_chart: Generate aviolinplot, used to display the distribution of data, combining features of boxplots and density plots to provide a more detailed view of the data distribution.generate_word_cloud_chart: Generate aword-cloud, used to display the frequency of words in textual data, with font sizes indicating the frequency of each word.generate_spreadsheet: Generate aspreadsheetor pivot table for displaying tabular data. When 'rows' or 'values' fields are provided, it renders as a pivot table (cross-tabulation); otherwise, it renders as a regular table.
[!NOTE] The above geographic visualization chart generation tool uses AMap service and currently only supports map generation within China.
🤖 Usage
To use with Desktop APP, such as Claude, VSCode, Cline, Cherry Studio, Cursor, and so on, add the MCP server config below. On Mac system:
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"]
}
}
}
On Window system:
{
"mcpServers": {
"mcp-server-chart": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@antv/mcp-server-chart"]
}
}
}
Also, you can use it on aliyun, modelscope, glama.ai, smithery.ai or others with HTTP, SSE Protocol.
🎨 Skill Usage
If you are using an AI IDE with skill support (like Claude Code), you can use the chart-visualization skill to automatically select the best chart type and generate visualizations.
You can add the skill from https://github.com/antvis/chart-visualization-skills using:
npx skills add antvis/chart-visualization-skills
Then provide your data or describe the visualization you want. The skill will intelligently choose from 25+ chart types and generate the chart for you.
🚰 Run with SSE or Streamable transport
Run directly
Install the package globally.
npm install -g @antv/mcp-server-chart
Run the server with your preferred transport option:
# For SSE transport (default endpoint: /sse)
mcp-server-chart --transport sse
# For Streamable transport with custom endpoint
mcp-server-chart --transport streamable
Then you can access the server at:
- SSE transport:
http://localhost:1122/sse - Streamable transport:
http://localhost:1122/mcp
Docker deploy
Enter the docker directory.
cd docker
Deploy using docker-compose.
docker compose up -d
Then you can access the server at:
- SSE transport:
http://localhost:1123/sse - Streamable transport:
http://localhost:1122/mcp
🎮 CLI Options
You can also use the following CLI options when running the MCP server. Command options by run cli with -H.
MCP Server Chart CLI
Options:
--transport, -t Specify the transport protocol: "stdio", "sse", or "streamable" (default: "stdio")
--host, -h Specify the host for SSE or streamable transport (default: localhost)
--port, -p Specify the port for SSE or streamable transport (default: 1122)
--endpoint, -e Specify the endpoint for the transport:
- For SSE: default is "/sse"
- For streamable: default is "/mcp"
--help, -H Show this help message
⚙️ Environment Variables
| Variable | Description | Default | Example |
|---|---|---|---|
VIS_REQUEST_SERVER |
Custom chart generation service URL for private deployment | https://antv-studio.alipay.com/api/gpt-vis |
https://your-server.com/api/chart |
SERVICE_ID |
Service identifier for chart generation records | - | your-service-id-123 |
DISABLED_TOOLS |
Comma-separated list of tool names to disable | - | generate_fishbone_diagram,generate_mind_map |
📠 Private Deployment
MCP Server Chart provides a free chart generation service by default. For users with a need for private deployment, they can try using VIS_REQUEST_SERVER to customize their own chart generation service.
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"],
"env": {
"VIS_REQUEST_SERVER": "<YOUR_VIS_REQUEST_SERVER>"
}
}
}
}
You can use AntV's project GPT-Vis-SSR to deploy an HTTP service in a private environment, and then pass the URL address through env VIS_REQUEST_SERVER.
- Method:
POST - Parameter: Which will be passed to
GPT-Vis-SSRfor rendering. Such as,{ "type": "line", "data": [{ "time": "2025-05", "value": 512 }, { "time": "2025-06", "value": 1024 }] }. - Return: The return object of HTTP service.
- success:
booleanWhether generate chart image successfully. - resultObj:
stringThe chart image url. - errorMessage:
stringWhensuccess = false, return the error message.
- success:
[!NOTE] The private deployment solution currently does not support geographic visualization chart generation include 3 tools:
geographic-district-map,geographic-path-map,geographic-pin-map.
🗺️ Generate Records
By default, users are required to save the results themselves, but we also provide a service for viewing the chart generation records, which requires users to generate a service identifier for themselves and configure it.
Use Alipay to scan and open the mini program to generate a personal service identifier (click the "My" menu below, enter the "My Services" page, click the "Generate" button, and click the "Copy" button after success):
Next, you need to add the SERVICE_ID environment variable to the MCP server configuration. For example, the configuration for Mac is as follows (for Windows systems, just add the env variable):
{
"mcpServers": {
"AntV Map": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"],
"env": {
"SERVICE_ID": "***********************************"
}
}
}
}
After updating the MCP Server configuration, you need to restart your AI client application and check again whether you have started and connected to the MCP Server successfully. Then you can try to generate the map again. After the generation is successful, you can go to the "My Map" page of the mini program to view your map generation records.
🎛️ Tool Filtering
You can disable specific chart generation tools using the DISABLED_TOOLS environment variable. This is useful when certain tools have compatibility issues with your MCP client or when you want to limit the available functionality.
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"],
"env": {
"DISABLED_TOOLS": "generate_fishbone_diagram,generate_mind_map"
}
}
}
}
Available tool names for filtering See the ✨ Features.
🔨 Development
Install dependencies:
npm install
Build the server:
npm run build
Start the MCP server:
npm run start
Start the MCP server with SSE transport:
node build/index.js -t sse
Start the MCP server with Streamable transport:
node build/index.js -t streamable
📄 License
MIT@AntV.
AntV Chart MCP questions
How do I add AntV Chart MCP to Claude Code?
Run claude mcp add --env 'SERVICE_ID=<YOUR_SERVICE_ID>' mcp-server-chart -- npx -y @antv/mcp-server-chart in your terminal. Add --scope user to make it available in every project.
How do I add AntV Chart MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does AntV Chart MCP provide?
It exposes 25 tools, including generate_area_chart, generate_bar_chart, generate_boxplot_chart, generate_column_chart, generate_district_map.
What chart types can the AntV chart MCP server generate?
It supports 26+ chart types including area, bar, line, pie, radar, sankey, treemap, venn, violin, word cloud, flow diagrams, mind maps and spreadsheets.
How do I install the chart MCP server for Claude or Cursor?
Add it to your MCP server config using npx with the package @antv/mcp-server-chart.
Can I self-host the chart generation service?
Yes, set the VIS_REQUEST_SERVER environment variable to your own GPT-Vis-SSR deployment, though geographic map charts are not supported in private deployment.
Can I disable specific chart tools?
Yes, pass a comma-separated list of tool names in the DISABLED_TOOLS environment variable.
Does it support SSE or HTTP transports?
Yes, run the server with --transport sse or --transport streamable to expose HTTP endpoints.