QuickChart

A Model Context Protocol server for generating charts using QuickChart.io . It allows you to create various types of charts through MCP tools.

javascript

159

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "gongrzhe-quickchart-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/quickchart-server/build/index.js"
      ]
    }
  }
}

You can generate charts by sending Chart.js configurations to this MCP server, which leverages QuickChart.io to produce chart images or URLs. This makes it easy to create a variety of chart types from data you provide, then reuse or embed the resulting visuals in your applications.

How to use

You use this server from an MCP client by invoking its available tools to create charts. The server exposes a chart generator that accepts standard Chart.js configurations and returns either a direct chart URL or a downloadable image. Use the URL to embed the chart in web pages or apps, or use a download action to save the image to your local or server storage.

How to install

Prerequisites you need before installation: Node.js (preferred if you are running the server locally) and npm for managing packages.

npm install @gongrzhe/quickchart-mcp-server

Configuration and runtime options

You can run the MCP server locally using a standard runtime command provided in setup examples. The configuration allows you to start the server in a local environment or invoke it via a package runner.

node /path/to/quickchart-server/build/index.js

Additional usage notes

Two practical ways to run the server from an MCP client are shown below. The first starts the server with a direct Node.js invocation pointing to the built index file. The second runs via a package runner to fetch and run the MCP server from the npm registry.

node
/path/to/quickchart-server/build/index.js

npx -y @gongrzhe/quickchart-mcp-server

Chart examples and formats

The server uses Chart.js configuration format. Here is a basic example of a bar chart configuration you can provide to generate a chart URL or image:

{
  "type": "bar",
  "data": {
    "labels": ["January", "February", "March"],
    "datasets": [{
      "label": "Sales",
      "data": [65, 59, 80],
      "backgroundColor": "rgb(75, 192, 192)"
    }]
  },
  "options": {
    "title": {
      "display": true,
      "text": "Monthly Sales"
    }
  }
}

Available tools

generate_chart

Generate a chart URL using QuickChart.io. You provide a Chart.js configuration and receive a URL to the generated chart.

download_chart

Download a chart image to a local file by supplying a chart configuration and an output path.