tech.unravel/mcp-vegalite-server

by unravel-team

1 stars
154 downloads
Not rated
GitHub

About

An MCP Server for creating beautiful visualisation using Vegalite (via vl-convert)

Details

Author
unravel-team
GitHub stars
1
Downloads
154
Categories
Other

Jump to

- Two simple tools: save-data and visualize-data
- Renders charts using vl-convert
- Designed for LLM‑guided chart creation
- Requires Java runtime
- Works with Claude Desktop and MCP Inspector

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name tech.unravel/mcp-vegalite-server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Build the JAR with make clean && make build, then run the server using the provided Java command, specifying the full path to the JAR and the vl-convert executable. Ensure vl-convert CLI is installed. Example configurations for Claude Desktop and MCP Inspector are included in the README.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "tech.unravel/mcp-vegalite-server": {
            "mcp-vegalite-server-unravel-team": {
                "command": "npx",
                "args": [
                    "@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"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-vegalite-server-unravel-team": {
        "command": "npx",
        "args": [
            "@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"
        ]
    }
}

tech.unravel/mcp-vegalite-server

An MCP server for working with Vegalite, using vl-convert.

We create two simple tools:
- save-data
- visualize-data

Using these, a host can create beautiful vegalite diagrams by:

- calculating the data needed and saving it,
- then generating the vegalite-spec using an LLM
- then rendering the spec using the data and access to vl-convert

Usage

Building the Jar

$ make clean && make build

Running the MCP server

PRE-REQUISITES: Needs vl-convert CLI to be installed.

Some example commands you can try in Claude Desktop or Inspector:

Here is some example data for you:

[

    { "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" }

]

Visualize this data for me using vega-lite.

Before running the vegalite MCP server

Remember: 1. Replace the full-path to the mcp-vegalite-server JAR with the correct path on your system 2. Specify the full-path to vl-convert on your system

In 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"
      ]
    }

In MCP Inspector

Remember to use the full-path to the mcp-vegalite-server JAR on your system. 
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

License

Copyright © 2025 Unravel.tech Engineering

Distributed under the MIT License

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Install

Add to Claude Desktop or Cursor

{
    "mcpServers": {
        "tech.unravel/mcp-vegalite-server": {
            "mcp-vegalite-server-unravel-team": {
                "command": "npx",
                "args": [
                    "@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"
                ]
            }
        }
    }
}

More like this

Similar MCP servers you might find useful

Browse category

Sequential Thinking

Sequential Thinking is an MCP server that provides a tool for dynamic and reflective problem-solving through a structured, step-by-step thinking process. It is…

88.2k
Other

Filesystem

Filesystem is a Node.js server that implements the Model Context Protocol (MCP) for filesystem operations. It enables AI assistants to read, write, and manage…

88.1k
Other

Reactive Resume

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5k
Other