Search2chart Mcp

io.github.iqingyoung由 GitHub 帳號 iqingyoung 發布v0.4.1更新於 Oct 24, 2026

跨客户端 ECharts 图表 MCP server:数据 -> 可交互 HTML 与内联图片

已驗證STDIO僅桌面資料與分析媒體與設計

概覽

AI 產生的概覽

本機 MCP 伺服器,把表格資料或 CSV/XLSX 檔案轉成 ECharts 圖表,回傳可互動 HTML 檔案與對話內嵌圖片。

可以做什麼
  • 用結構化資料或 CSV/XLSX 檔案路徑產生圖表,輸出可互動 HTML 檔案與內嵌圖片。
  • 列出支援的圖表類型、配色與欄位約定,chartType 為 auto 時自動選擇圓餅圖或長條圖。
  • 選擇圖片回傳方式:data URI、本機 HTTP、檔案路徑、公開 CDN 連結、MCP 圖片區塊,或僅回傳 HTML 路徑的純文字。
  • 隨圖表一併回傳清洗後的 JSON 資料,方便純文字模型繼續做占比與趨勢分析。
適用情境
適合需要在對話中把表格結果視覺化的情境,例如把查詢結果或試算表做成長條圖、圓餅圖,或產生可在瀏覽器開啟的獨立互動式 HTML 圖表。
執行需求
透過 stdio 在本機執行,通常以 npx search2chart-mcp(需 Node.js)或複製後的 server.js 路徑啟動。可選環境變數 ECHARTS_INLINE_MODE 用來選擇圖片輸出模式;未宣告需要帳號或 API 金鑰。
安裝前請注意
cdn 模式會透過 GitHub Contents API 把產生的圖表上傳到 GitHub 並經公開 CDN 提供,圖表圖片會離開本機,定時清理預設保留約三天。圖表同時寫入本機 .html 檔案。各用戶端渲染支援不同,建議先測試輸出模式。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Search2chart Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[DSH Market] [MCP] [Downloads]

search2chart-mcp

Turn any tabular data into inline charts directly inside agent conversations. Zero runtime dependencies, multi-client adaptive.

把「任意表格数据」变成直接内联在 agent 对话流里的图表。零运行时依赖,多端自适应。

[image]

安装

bash
# 方式一:DSH 原生插件(DeepSeek Harness 用户推荐,真·内联)dsh plugin --profile web add dsh-chart
# 方式二:npx(通用 MCP server,无需 clone)npx search2chart-mcp
# 方式三:git clonegit clone https://github.com/iqingyoung/search2chart-mcp.git

两条路径

路径目录适用
通用 MCP servermcp/ZCode / Claude Desktop / Cursor / WorkBuddy / Trae / Codex / DSH 通用
原生 DSH 插件dsh/DeepSeek Harness(真·内联,图片直接进对话)
  • 用 MCP 客户端 → 用 mcp/,对话框直接出图
  • 用 DSH 且想要原生体验 → 用 dsh/;DSH 里也能用 mcp/(走文件链接)
  • 两者可并存

快速开始

1. 在你的 MCP 配置里加入

json
{  "mcpServers": {    "search2chart-mcp": {      "command": "npx",      "args": ["search2chart-mcp"],      "env": {}    }  }}

如果 npx 拉不到,用 clone 后的绝对路径:"command": "node", "args": ["<仓库>/mcp/server.js"]

2. 首次接入:测试你的 Agent 能渲染哪种图片

不同 Agent 渲染器对图片格式支持各异。先用 all 模式一次性测试:

临时配置(在 MCP 配置里加环境变量):

json
{  "env": {    "ECHARTS_INLINE_MODE": "all"  }}

发给 Agent 的测试 prompt:

用 chart_from_data 生成一个简单柱状图。数据:[["城市","销量"],["北京",120],["上海",200],["广州",150]]标题:城市销量对比chartType:bar

Agent 返回 3-4 行图,分别标记为:

  • 【1·data URI】 — 自包含 base64,无需联网
  • 【2·localhost http】 — 本地 HTTP 服务
  • 【3·file://】 — 本地文件路径
  • 【4·CDN 公网 https】 — GitHub + jsDelivr 公网地址

哪个在对话框里真正渲染成了图片,你的 Agent 就支持哪种。

3. 固定模式

能渲染的格式设置
data URI ✅ECHARTS_INLINE_MODE=inline(默认)
file:// ✅ECHARTS_INLINE_MODE=file
localhost http ✅ECHARTS_INLINE_MODE=inline
CDN 公网 https ✅ECHARTS_INLINE_MODE=cdn
MCP image block ✅inline + 调用时 returnImage:true
都显示不了ECHARTS_INLINE_MODE=none,用 .html 交互图

Agent 自动检测

工具结果里已内置 Agent 指令,告诉模型如何根据用户反馈自动设置模式:

[Agent]: 返回 4 行图片,哪张正常显示?[User]:  3正常[Agent]: 确认了。file:// 可渲染 → 请设置 ECHARTS_INLINE_MODE=file

已知客户端实测:ZCode → file,OpenCode → inline(data URI),WorkBuddy → cdn,DSH → inline(localhost http),Claude/Cursor → inline + returnImage:true。

核心能力

多客户端内联适配

通过 ECHARTS_INLINE_MODE 环境变量控制内联行为:

模式行为适用客户端
inline(默认)data URI → localhost http → file:// 自动 fallbackOpenCode / DSH / 通用
file只输出 file:// 本地路径ZCode
cdn上传 GitHub+jsDelivr,输出公网 httpsWorkBuddy
all测试模式:一次返回所有格式首次接入时测试
none纯文本(.html 路径 + 数据),无内联纯文本模型 / 终端

CDN 公网图床

  • SVG → PNG 栅格化(@resvg/resvg-js,可选依赖)
  • GitHub Contents API 上传 + jsDelivr CDN 加速
  • GitHub Actions 定时清理(默认保留 3 天)

清洗数据留存

结果附带完整数据(JSON,代码块包裹),让纯文本模型在上下文里继续做占比/趋势/对比分析,无需看图。returnData: false 可关。

自包含可交互 HTML

图表同时写入 .html 文件,浏览器打开即支持 hover / 缩放 / 类型切换 / 配色调整。

工具

工具作用
chart_from_data结构化数据 → 图表 HTML + 内联图片
chart_from_fileCSV/XLSX 路径 → 图表 HTML + 内联图片
list_chart_types列出支持的类型 / 配色与字段约定

字段约定:第一列 = 类别轴;其余列 = 数值序列(多列即多序列);chartType: auto 按数据自动选 饼/柱。

接入各客户端

详见 mcp/README.md。

目录

search2chart-mcp/├── mcp/              # 跨端 MCP server(内联 SVG + 可交互 HTML)│   ├── server.js     # MCP stdio 协议 + 工具入口│   ├── lib/│   │   ├── chart.js      # 数据归一化 + ECharts option│   │   ├── html.js       # 自包含可交互 HTML│   │   ├── svg.js        # 零依赖 SVG 渲染器│   │   ├── httpserver.js # 本地 HTTP 服务│   │   ├── rasterize.js  # SVG→PNG│   │   ├── upload.js     # GitHub + jsDelivr CDN│   │   └── parse.js      # CSV/XLSX 解析│   └── scripts/│       ├── selftest.js    # 端到端自检│       └── verify_cdn.cjs # CDN 端到端验证├── dsh/              # 原生 DSH 内联插件├── LICENSE└── README.md

License

MIT

來源:README.md,提交 da37d08

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.4.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分