Skip to main content
Glama

Vega-Lite & Deneb MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to Vega-Lite and Deneb documentation, examples, and validation tools.

What it does

This server enables AI assistants like Claude to:

  • πŸ” Search Vega-Lite and Deneb documentation

  • πŸ“Š Get visualization examples by category

  • βœ… Validate Vega-Lite specifications

  • πŸ“– Access schema information

  • πŸ’Ό Power BI integration via Deneb documentation

Related MCP server: BI Chart MCP Server

Quick Start

1. Install

# Clone the repository
git clone https://github.com/inteligencianegociosmmx/vegaLite_mcp_server.git
cd vegaLite_mcp_server

# Install dependencies and build
npm install
npm run build

2. Configure

Claude Code (VS Code) - Recommended ⭐

# One command installation
claude mcp add vegalite node /path/to/vegaLite_mcp_server/dist/index.js

Then completely close and reopen VS Code (important - don't just reload).

Claude Desktop

Edit your config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Add:

{
  "mcpServers": {
    "vegalite": {
      "command": "node",
      "args": ["/absolute/path/to/vegaLite_mcp_server/dist/index.js"]
    }
  }
}

Restart Claude Desktop.

3. Verify

Claude Code: Type /mcp - you should see "vegalite" listed

Claude Desktop: Look for the πŸ”¨ tools indicator

4. Try it

Search for "bar chart" in Vega-Lite
Show me a scatter plot example
Validate this spec: {"$schema": "https://vega.github.io/schema/vega-lite/v5.json", "mark": "bar", ...}

Available Tools

Tool

What it does

Example

search_docs

Search Vega-Lite and Deneb docs

"How do filter transforms work?" or "How does Deneb work with Power BI?"

get_example

Get examples by category

"Show me a line chart example"

validate_spec

Validate JSON specs

"Validate this Vega-Lite spec: {...}"

get_schema_info

Get schema details

"What encoding channels are available?"

πŸ†• Deneb Support

Deneb is a certified custom visual for Microsoft Power BI that uses Vega-Lite. This server now includes Deneb documentation to help Power BI users:

  • Understand how to use Vega-Lite in Power BI

  • Learn about Power BI-specific features (cross-filtering, tooltips, etc.)

  • Get examples specific to the Power BI context

Try: "How do I use cross-filtering in Deneb?" or "What's the difference between Vega-Lite and Deneb?"

Troubleshooting

Server not showing up?

  1. Check the path is absolute and correct

  2. Test manually: node /path/to/dist/index.js (should say "running on stdio")

  3. For Claude Code: Completely close and reopen VS Code (not just reload)

  4. Verify with /mcp (Claude Code) or look for tools indicator (Claude Desktop)

Tools not working?

npm run build  # Rebuild the project

Remove the server:

claude mcp remove vegalite  # Claude Code
# Or manually delete from config file

Development

npm run watch        # Auto-rebuild on changes
npm run scrape      # Fetch latest Vega-Lite docs

Project Structure

src/
β”œβ”€β”€ index.ts              # Main MCP server
β”œβ”€β”€ tools/
β”‚   β”œβ”€β”€ search.ts        # Documentation search
β”‚   β”œβ”€β”€ examples.ts      # Example retrieval
β”‚   └── validate.ts      # Spec validation
└── utils/
    └── scraper.ts       # Documentation scraper

Manual Configuration

Claude Code (Manual)

  1. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)

  2. Type: Claude Code: Edit MCP Settings

  3. Add:

{
  "mcpServers": {
    "vegalite": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"]
    }
  }
}
  1. Save and completely close/reopen VS Code

Other MCP Clients

Add the same configuration to your client's MCP settings file. Check your client's documentation for the config file location.

Contributing

Contributions welcome! Please submit a Pull Request.

See CONTRIBUTING.md for development guidelines.

Future Features

For information about deploying as a remote server, see docs/DEPLOYMENT.md.

License

MIT License - See LICENSE


Built with Model Context Protocol β€’ Powered by Vega-Lite

Available Tools

4 tools
get_exampleB

Retrieve Vega-Lite example specifications by category or type

Inputs: category (required), search.

get_schema_infoC

Get information about Vega-Lite schema properties and structure

Inputs: property.

search_docsC

Search through Vega-Lite documentation for information about charts, encodings, marks, and more

Inputs: query (required).

validate_specC

Validate a Vega-Lite specification and check for errors

Inputs: spec (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: get_example retrieves examples, get_schema_info provides schema details, search_docs searches documentation, and validate_spec validates specifications. There is no overlap in functionality, making tool selection straightforward for an agent.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (get_example, get_schema_info, search_docs, validate_spec) with clear, descriptive verbs. This uniformity enhances readability and predictability across the tool set.

    Tool Count5/5

    With 4 tools, the server is well-scoped for its purpose of supporting Vega-Lite chart development. Each tool serves a distinct, essential function (examples, schema, docs, validation), and there are no extraneous tools, making the count appropriate.

    Completeness4/5

    The tool set covers key aspects of Vega-Lite usage: examples, schema info, documentation search, and spec validation. A minor gap exists in lacking tools for generating or modifying specifications, but agents can work around this using the provided tools effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides tools for AI assistants to access the Agent Web Protocol (AWP) specification, validate agent.json files, and generate protocol-compliant configurations. It enables developers to integrate the AWP standard into their websites through natural language prompts and automated validation.
      8 npm
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Provides AI agents with D3.js API documentation and example code from d3js.org and Observable gallery, enabling module discovery, documentation search, and example extraction.
      5
      1
      -