tech.unravel/mcp-vegalite-server

Name: tech.unravel/mcp-vegalite-server
Author: unravel-team

本地服务

github.com/unravel-team数据与分析179 周前更新

代码仓库

关于 tech.unravel/mcp-vegalite-server

这是一个使用 `vl-convert` 准备数据并渲染 Vega-Lite 可视化的 MCP 服务。它提供两步流程，供主机生成可视化规格并完成渲染。

主要功能

01保存可视化数据
02渲染 Vega-Lite 规格
03使用 `vl-convert` 渲染

适用场景

01将整理后的数据转换为 Vega-Lite 图表
02渲染 LLM 生成的可视化规格

MCP 相关

向 MCP 客户端提供 `save-data` 和 `visualize-data` 工具，用于保存数据并渲染 Vega-Lite 规格。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "vegalite-server-unravel-team": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@modelcontextprotocol/inspectorstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

tech.unravel/mcp-vegalite-server

一个用于处理 Vegalite 的 MCP 服务，使用 vl-convert。

我们创建了两个简单的工具：

save-data
visualize-data

借助这些工具，主机可以创建精美的 vegalite 图表，方法如下：

计算所需数据并保存，
然后使用 LLM 生成 vegalite-spec
最后使用数据和 vl-convert 来渲染该规范

用法

构建 Jar

$ make clean && make build

运行 MCP 服务

前置条件：需要安装 vl-convert CLI。

以下是一些你可以在 Claude Desktop 或 Inspector 中尝试的示例命令：

以下是一些示例数据：

[
    { "year": 2011, "value": 14.6, "growth_type": "Market Cap Growth" },
    { "year": 2011, "value": 11.4, "growth_type": "Revenue Growth" },
    { "year": 2011, "value": 26.6, "growth_type": "Net Income Growth" },
    { "year": 2012, "value": 40.1, "growth_type": "Market Cap Growth" },
    { "year": 2012, "value": 42.7, "growth_type": "Revenue Growth" },
    { "year": 2012, "value": 36.9, "growth_type": "Net Income Growth" },
    { "year": 2013, "value": 16.9, "growth_type": "Market Cap Growth" },
    { "year": 2013, "value": 14.6, "growth_type": "Revenue Growth" },
    { "year": 2013, "value": 15.3, "growth_type": "Net Income Growth" },
    { "year": 2014, "value": 9.6, "growth_type": "Market Cap Growth" },
    { "year": 2014, "value": 7.9, "growth_type": "Revenue Growth" },
    { "year": 2014, "value": 10.9, "growth_type": "Net Income Growth" },
    { "year": 2015, "value": 5.8, "growth_type": "Market Cap Growth" },
    { "year": 2015, "value": 6.7, "growth_type": "Revenue Growth" },
    { "year": 2015, "value": 6.2, "growth_type": "Net Income Growth" },
    { "year": 2016, "value": -12.4, "growth_type": "Market Cap Growth" },
    { "year": 2016, "value": -3.9, "growth_type": "Revenue Growth" },
    { "year": 2016, "value": -32.2, "growth_type": "Net Income Growth" },
    { "year": 2017, "value": 25.3, "growth_type": "Market Cap Growth" },
    { "year": 2017, "value": 5.9, "growth_type": "Revenue Growth" },
    { "year": 2017, "value": 43.9, "growth_type": "Net Income Growth" }
]

请使用 vega-lite 为我可视化这些数据。

运行 vegalite MCP 服务之前

请记住：

将 mcp-vegalite-server JAR 的完整路径替换为你系统上的正确路径
指定你系统上 vl-convert 的完整路径

在 Claude Desktop 中

    "vegalite": {
      "command": "java",
      "args": [
        "-Dclojure.tools.logging.factory=clojure.tools.logging.impl/log4j2-factory",
        "-Dorg.eclipse.jetty.util.log.class=org.eclipse.jetty.util.log.Slf4jLog",
        "-Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector",
        "-Dlog4j2.configurationFile=log4j2-mcp.xml",
        "-Dbabashka.json.provider=metosin/jsonista",
        "-Dlogging.level=INFO",
        "-Dmcp.vegalite.vl_convert_executable=/Users/vedang/.cargo/bin/vl-convert",
        "-cp",
        "/Users/vedang/mcp-vegalite-server/target/tech.unravel/mcp-vegalite-server-1.0.0.jar",
        "tech.unravel.mcp_vegalite_server"
      ]
    }

在 MCP Inspector 中

请记得使用你系统上 mcp-vegalite-server JAR 的完整路径。

npx @modelcontextprotocol/inspector java -Dclojure.tools.logging.factory=clojure.tools.logging.impl/log4j2-factory -Dorg.eclipse.jetty.util.log.class=org.eclipse.jetty.util.log.Slf4jLog -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector -Dlog4j2.configurationFile=log4j2-mcp.xml -Dbabashka.json.provider=metosin/jsonista -Dlogging.level=INFO -Dmcp.vegalite.vl_convert_executable=/Users/vedang/.cargo/bin/vl-convert -cp /Users/vedang/mcp-vegalite-server/target/tech.unravel/mcp-vegalite-server-1.0.0.jar tech.unravel.mcp_vegalite_server