Skip to main content
Glama

Vega-Lite MCP Server

Vega-Lite MCP Server

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

What it does

This server enables AI assistants like Claude to:

  • šŸ” Search Vega-Lite documentation

  • šŸ“Š Get visualization examples by category

  • āœ… Validate Vega-Lite specifications

  • šŸ“– Access schema information

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 documentation

"How do filter transforms work?"

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?"

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

Links


Built with

Deploy Server
-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides AI assistants with access to Vega-Lite documentation, visualization examples, and specification validation tools. Enables searching docs, retrieving examples by category, validating JSON specs, and accessing schema information for creating data visualizations.

  1. What it does
    1. Quick Start
      1. 1. Install
      2. 2. Configure
      3. 3. Verify
      4. 4. Try it
    2. Available Tools
      1. Troubleshooting
        1. Development
          1. Project Structure
        2. Manual Configuration
          1. Claude Code (Manual)
          2. Other MCP Clients
        3. Contributing
          1. Future Features
            1. License
              1. Links

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/inteligencianegociosmmx/vegaLite_mcp_server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server