MCP Server Chart

You can deploy and run a TypeScript-based MCP server that generates AntV charts and performs data analysis. This server exposes a range of chart generation capabilities through MCP tooling, enabling you to produce visualizations directly from your data pipelines or AI-assisted workflows.

How to use

You interact with the MCP server by configuring it in your MCP client to run locally or remotely. You can choose between transport methods such as server-sent events (SSE) or a streamable transport depending on your client’s capabilities. Once configured, you can request chart generation or data analysis tasks through the MCP client, and the server returns chart outputs or data-driven insights. If you are using an AI IDE with skills support, you can leverage specialized chart-visualization skills to automatically select the best chart type and generate visualizations.

Practical usage patterns include setting up the server in your development environment, connecting your MCP-capable client, and selecting the chart type you need. You can also opt for private deployment by pointing the server to your own chart generation service endpoint if you require a self-contained or restricted environment.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system. You may also install locally or run via a package runner to fetch the MCP server executable.

Install, build, and start the server with these steps if you are running locally on your machine:

# Install dependencies and build the server
npm install
npm run build

# Start the MCP server with a standard transport (stdio) for local use
npm run start

# Or start directly with a specific transport if you prefer SSE or streamable
node build/index.js -t sse

Additional sections

Environment variables you may configure include SERVICE_ID, VIS_REQUEST_SERVER, and DISABLED_TOOLS to tailor the server behavior and available chart tools.

Private deployment lets you point the server to a private chart generation service. You can provide your own endpoint by setting VIS_REQUEST_SERVER in the server configuration and restarting your client.

If you want to generate mapping records or visualize map data, you can enable the chart generation flow and view results on your own records page after generating a service identifier.

Tool filtering allows you to disable specific chart generation tools by configuring DISABLED_TOOLS so you can constrain available functionality to match client capabilities or requirements.

For development, you can build and run the server locally using standard npm commands, or run the final build with a direct Node command for SSE or streamable transports.

The project is released under MIT, allowing you to adopt, modify, and deploy in your environment.

Environment variables

You can customize the server’s behavior with the following environment variables.

Private deployment configuration

To use a private chart generation service, configure VIS_REQUEST_SERVER to point to your own HTTP endpoint and restart your client so requests are routed to your service.

{
  "mcpServers": {
    "mcp-server-chart": {
      "command": "npx",
      "args": ["-y", "@antv/mcp-server-chart"],
      "env": {
        "VIS_REQUEST_SERVER": "<YOUR_VIS_REQUEST_SERVER>"
      }
    }
  }
}

Generate Records

If you want to view your chart generation records, you can obtain a service identifier and configure it in your MCP client. Follow the process to generate a personal service identifier and include it in the MCP server configuration under SERVICE_ID.

Tool Filtering

Use the DISABLED_TOOLS environment variable to disable specific chart generation tools when needed.

Development

Development steps include installing dependencies, building, and starting the server. You can run the server with SSE or streamable transport.

License

MIT license applies to this project.

Available tools

generate_area_chart

Generate an area chart to display trends over a continuous variable and observe overall data patterns.

generate_bar_chart

Generate a bar chart to compare values across different categories, suitable for horizontal comparisons.

generate_boxplot_chart

Generate a boxplot to visualize data distribution, including median, quartiles, and outliers.

generate_column_chart

Generate a column chart to compare values across categories in a vertical layout.

generate_district_map

Generate a district map to show administrative divisions and data distribution.

generate_dual_axes_chart

Generate a dual-axes chart to display relationships between two variables with different units.

generate_fishbone_diagram

Generate a fishbone (Ishikawa) diagram to identify root causes of a problem.

generate_flow_diagram

Generate a flowchart to visualize steps and sequences in a process.

generate_funnel_chart

Generate a funnel chart to illustrate data loss across stages.

generate_histogram_chart

Generate a histogram to display data distribution by counting observations in intervals.

generate_line_chart

Generate a line chart to show data trends over time or another continuous variable.

generate_liquid_chart

Generate a liquid chart to visualize proportions using water-fill representations.

generate_mind_map

Generate a mind-map to display hierarchical information and thought structure.

generate_network_graph

Generate a network graph to show relationships and connections between nodes.

generate_organization_chart

Generate an organizational chart to display structure and personnel relationships.

generate_path_map

Generate a path-map to visualize route planning results for points of interest.

generate_pie_chart

Generate a pie chart to show data proportions as segments of a circle.

generate_pin_map

Generate a pin-map to display the geographic distribution of points of interest.

generate_radar_chart

Generate a radar chart to display multi-dimensional data across multiple axes.

generate_sankey_chart

Generate a sankey chart to illustrate data flow and volume between nodes.

generate_scatter_chart

Generate a scatter plot to show relationships between two variables.

generate_treemap_chart

Generate a treemap to visualize hierarchical data with area-encoded values.

generate_venn_chart

Generate a Venn diagram to show relationships between sets.

generate_violin_chart

Generate a violin plot combining density and distribution information.

generate_word_cloud_chart

Generate a word cloud to display word frequency with font size indicating prevalence.

generate_spreadsheet

Generate a spreadsheet or pivot table for tabular data, rendering as cross-tabulation when rows/values are provided.