๐ค A visualization mcp & skills contains 25+ visual charts using @antvis. Using for chart generation and data analysis.
# MCP Server Chart
A Model Context Protocol server for generating charts using [AntV](https://github.com/antvis/). We can use this mcp server for _chart generation_ and _data analysis_.
 [. We can use this mcp server for _chart generation_ and _data analysis_.
 [; 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:
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.
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.
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-SSR for rendering. Such as, { "type": "line", "data": [{ "time": "2025-05", "value": 512 }, { "time": "2025-06", "value": 1024 }] }.
errorMessage: string When success = false, return the error message.
[!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):
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.