Skip to content

antvis/mcp-server-chart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

34 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

MCP Server Chart build npm Version smithery badge npm License

A Model Context Protocol server for generating charts using AntV.

This is a TypeScript-based MCP server that provides chart generation capabilities. It allows you to create various types of charts through MCP tools.

โœจ Features

Now 15+ charts supported.

mcp-server-chart preview

  • generate_area_chart - Generate a area chart, and return an image URL.
  • generate_bar_chart - Generate a bar chart, and return an image URL.
  • generate_column_chart - Generate a column chart, and return an image URL.
  • generate_dual_axes_chart - Generate a dual-axes chart, and return an image URL.
  • generate_fishbone_diagram - Generate a fishbone-diagram chart, and return an image URL.
  • generate_flow_diagram - Generate a flow-diagram chart, and return an image URL.
  • generate_histogram_chart - Generate a histogram chart, and return an image URL.
  • generate_line_chart - Generate a line chart, and return an image URL.
  • generate_mind_map - Generate a mind-map chart, and return an image URL.
  • generate_network_graph - Generate a network-graph chart, and return an image URL.
  • generate_pie_chart - Generate a pie chart, and return an image URL.
  • generate_radar_chart - Generate a radar chart, and return an image URL.
  • generate_scatter_chart - Generate a scatter chart, and return an image URL.
  • generate_treemap_chart - Generate a treemap chart, and return an image URL.
  • generate_word_cloud_chart - Generate a word-cloud chart, and return an image URL.

๐Ÿค– Usage

To use with Desktop APP, such as Claude, VSCode, Cline, Cherry Studio, 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.

๐Ÿšฐ Run with SSE or Streamable transport

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

๐ŸŽฎ 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")
  --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

๐Ÿ“  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.

๐Ÿ”จ Development

Install dependencies:

npm install

Build the server:

npm run build

Start the MCP server:

npm run start

๐Ÿ“„ License

MIT@AntV.