Docker 快速搭建一个基于 GPT-Vis 组件的统计图表生成服务

luler · 2025-06-17T10:02:36+00:00

一、简介可以在服务端使用 GPT-Vis 统计图表组件直接渲染成图片支持Docker一键部署，提供统计图表渲染生成API接口支持多种GPT-Vis支持的组件，包括折线图、柱形图、饼图、面积图、条形图、直方图、散点图、词云图、雷达图、思维导图、流程图等等可以作为MCP工具 MCP Server Char...

luler

一、简介

可以在服务端使用 GPT-Vis 统计图表组件直接渲染成图片
支持Docker一键部署，提供统计图表渲染生成API接口
支持多种GPT-Vis支持的组件，包括折线图、柱形图、饼图、面积图、条形图、直方图、散点图、词云图、雷达图、思维导图、流程图等等
可以作为MCP工具 MCP Server Chart 的私有后端服务，参考：https://github.com/antvis/mcp-server-chart
参考GPT-Vis组件使用文档：https://gpt-vis.antv.vision/components/line
本工具开源地址：https://github.com/luler/gpt_vis_ssr
工作原理图参考：

二、安装

提前准备好Docker、docker-compose软件环境（自行搭建，这里不在赘述）

新建docker-compose.yml配置文件，内容如下：

version: '3.8'

services:
  gpt-vis-ssr:
    image: ghcr.io/luler/gpt_vis_ssr:latest
    ports:
      - 3000:3000
    volumes:
      - ./images:/app/public/images
    environment:
      - NODE_ENV=production
      - TZ=Asia/Shanghai
    restart: unless-stopped

一键启动

docker-compose up -d

三、使用示例

1. 直接调用统计图渲染接口

提供接口：http://127.0.0.1:3000/render
请求方法：POST

请求参数（JSON格式），例如

{
    "type": "column",
    "data": [
        {
            "category": "交通",
            "value": 2000
        },
        {
            "category": "住宿",
            "value": 1200
        },
        {
            "category": "吃喝",
            "value": 1000
        },
        {
            "category": "门票",
            "value": 800
        },
        {
            "category": "其他",
            "value": 300
        }
    ],
    "title": "旅行计划费用统计",
    "axisXTitle": "费用类别",
    "axisYTitle": "金额 (元)"
}

更多请求参数参考：https://gpt-vis.antv.vision/components/column

返回json格式数据，参考：

{
    "success": true,  //是否渲染生成成功，true-成功，false-失败
    "resultObj": "http://127.0.0.1:3000/images/c1e17b0f-513d-46de-ae74-e0d20ae52bd7.png", //生成的图表图片访问链接
    "errorMessage": "" //success=false时，返回相关错误信息
}

输出图片示例如下

2. 作为在 MCP Server Chart 工具的私有服务后端使用

在Cherry Studio配置使用，增加环境变量 VIS_REQUEST_SERVER=http(s)://ip_or_domain/render，配置参考下图：
使用MCP Server Chart，并通过自己的统计图表渲染服务生成相关图片，保证数据安全性

四、总结

这是一个服务端统计图表渲染制图小工具，方便通过接口调用实现统计图表生成
Docker一键部署，快速应用
接口兼容 MCP Server Chart 工具，可作为其私有化后端服务