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

一、简介

• 可以在服务端使用 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 工具，可作为其私有化后端服务