图表生成工具

一个本地化的图表生成工具,支持20多种图表类型,适用于安全环境和离线部署。

  • by yaonyan
  • TypeScript
  • 混合部署
  • 21 星标
  • 更新于
在 GitHub 查看 mcpc-tech/gpt-vis-mcp

使用说明

GPT Vis MCP服务器

A. 本地/私人青睐的包装 为了 antvis/mcp服务器图表 那 在本地生成图表,不依赖于外部服务器。

✨ 特性

  • 🔒 私密且安全:本地图表生成,无外部依赖关系
  • 🚀 轻松设置:Claude Desktop的一个命令安装
  • 🎨 丰富的图表:20多种图表类型(饼图、折线图、条形图、雷达图、地图等)
  • 📊 企业就绪:非常适合安全环境

🚀 用法

克劳德桌面(推荐)

添加到您的Claude Desktop MCP设置中:

选项1:NPX(推荐)

{
  "mcpServers": {
    "gpt-vis-mcp": {
      "command": "npx",
      "args": ["-y", "@jsr2npm/yao__gpt-vis-mcp@latest"]
    }
  }
}

选项2:Deno Direct

{
  "mcpServers": {
    "gpt-vis-mcp": {
      "command": "deno",
      "args": ["run", "--allow-all", "@yao/gpt-vis-mcp/bin"]
    }
  }
}

选项3:NPX+Deno

{
  "mcpServers": {
    "gpt-vis-mcp": {
      "command": "npx",
      "args": ["-y", "deno", "run", "--allow-all", "@yao/gpt-vis-mcp/bin"]
    }
  }
}

您可能会经历 canvas 使用npx时的依赖性问题和字体呈现问题。如果是这样,请尝试选项4。

选项4:Docker

{
  "mcpServers": {
    "gpt-vis-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--interactive",
        "--rm",
        "-v",
        "/tmp/gpt-vis-charts:/tmp/gpt-vis-charts",
        "ghcr.io/yaonyan/gpt-vis-mcp:latest-mcp"
      ]
    }
  }
}

直接命令行使用

您还可以使用各种传输模式直接运行服务器:

# Using JSR package (recommended)
# Default stdio mode (for MCP clients)
deno run --allow-all @yao/gpt-vis-mcp/bin

# SSE server mode
deno run --allow-all @yao/gpt-vis-mcp/bin --transport sse --port 3000 --host localhost

# Short form
deno run --allow-all @yao/gpt-vis-mcp/bin -t sse -p 3000 -h localhost

# Show help
deno run --allow-all @yao/gpt-vis-mcp/bin --help
# Alternative: Using npx with deno
# Default stdio mode
npx -y deno run --allow-all @yao/gpt-vis-mcp/bin

# SSE server mode  
npx -y deno run --allow-all @yao/gpt-vis-mcp/bin --transport sse --port 3000

# Show help
npx -y deno run --allow-all @yao/gpt-vis-mcp/bin --help

运输方式:

  • stdio:通过stdin/stdout直接进行MCP协议通信(默认)
  • sse:web客户端的服务器发送事件HTTP服务器

带SSE模式的Docker

# Run with SSE server
docker run -p 3000:3000 ghcr.io/yaonyan/gpt-vis-mcp:latest-mcp --transport sse --port 3000 --host 0.0.0.0

# Access the SSE endpoint
curl http://localhost:3000/sse

离线环境支持: Docker镜像旨在在气隙/离线环境中工作。在构建阶段缓存所有依赖项 DENO_CACHED_ONLY 环境变量确保在运行时不会发出网络请求。

根据需要设置环境变量:

变量 描述 默认值
RENDERED_IMAGE_PATH 图表图像目录 系统临时
RENDERED_IMAGE_HOST_PATH 访问图像的基本URL (可选)
DENO_CACHED_ONLY 在离线模式下运行 true (在Docker中)

Docker SSR服务器

我们还提供符合以下要求的SSR服务器https://github.com/antvis/mcp-server-chart?tab=readme-ov文件#-私有部署

# Run SSR API server
docker run -p 3000:3000 -e RENDERED_IMAGE_HOST_PATH=http://localhost:3000/charts ghcr.io/yaonyan/gpt-vis-mcp:latest-http

# Test the SSR API
❯ curl -X POST http://localhost:3000/generate \
             -H "Content-Type: application/json" \
             -d '{"type": "pie", "data": [{"category": "A", "value": 30}, {"category": "B", "value": 70}]}'
{"success":true,"resultObj":"http://localhost:3000/charts/chart_1750500506056_T6IC0Vtp.png"}

然后,您可以将SSR服务器与上游一起使用 @antv/mcp-server-chart 通过指定 VIS_REQUEST_SERVER 环境变量:

{
  "mcpServers": {
    "mcp-server-chart": {
      "command": "npx",
      "args": ["-y", "@antv/mcp-server-chart"],
      "env": {
        "VIS_REQUEST_SERVER": "http://localhost:3000/generate"
      }
    }
  }
}

这允许您在利用私有SSR端点生成图表的同时使用原始MCP服务器。

🤝 贡献

看 贡献.md 用于开发设置。

📄 许可证

MIT许可证-请参阅 许可证