MCP Vegalite Server

🚀 Model Context Protocol (MCP) Server for Data Visualization

An implementation of a Model Context Protocol (MCP) server that provides an interface for large language models to visualize data using Vega - Lite syntax.

🚀 Quick Start

✨ Features

The server offers two core tools:

• save_data

  • Saves a data table containing aggregated data to the server for later visualization.
  • Input:
    • name (string): The name of the data table.
    • data (array): An array of objects representing the data table.
  • Returns: A success message.

• visualize_data

  • Visualizes data using Vega - Lite syntax.
  • Input:
    • data_name (string): The name of the data table to be visualized.
    • vegalite_specification (string): A JSON string representing the Vega - Lite specification.
  • Returns: If --output_type is set to text, it returns a success message with an additional artifact key containing the full Vega - Lite specification with data. If --output_type is set to png, it returns a base64 - encoded PNG image using the MPC ImageContent container.

💻 Usage Examples

Basic Usage

# Add the server to your claude_desktop_config.json
{
  "mcpServers": {
    "datavis": {
        "command": "uv",
        "args": [
            "--directory",
            "/absolute/path/to/mcp-datavis-server",
            "run",
            "mcp_server_datavis",
            "--output_type",
            "png" # or "text"
        ]
    }
  }
}