Skip to content
MCP server

AVIZ

MCP server that lets AI agents build audio-reactive music visual scenes as shareable links

Runs locally
Install

AVIZ is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
Web, macOS, CLI
Runs
Locally
Version
0.2.2
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add aviz-mcp -- npx -y aviz-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "aviz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aviz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "aviz-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aviz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aviz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

About AVIZ

The README and site describe this as a local MCP server that turns plain-language requests into music visuals. An agent picks from a library of 114 effects and 117 templates, binds parameters to the bass, kick, drop, energy or tempo of a track, and returns a link that opens the scene in the browser or in AVIZ for Mac.

Before returning a link, the agent checks the scene against the same code the app uses to open links, and it can render a PNG or short MP4 preview on the user's computer to review the result. The server runs locally through npx on Node.js 22 or later and, per the site, talks to no AVIZ service; the whole scene is encoded in the link after the # so nothing is uploaded.

It suits people who already work in an AI assistant such as Claude, Cursor or VS Code and want to generate light shows or visual accompaniment for electronic music without opening a visual editor. Previews require Google Chrome, Chromium or Edge, and short MP4 previews also need ffmpeg.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

list_effects
Lists every effect with its parameters, ranges, options and default music bindings.
list_templates
Lists the ready-made scenes available as a starting point.
get_template
Retrieves a single ready-made scene template.
build_scene
Builds a checked scene and its link, or returns errors describing what to change.
preview
Renders a PNG frame or short MP4 of the scene using the AVIZ engine on a synthetic beat.

What it does

Plain-language scene building
Describe the look and rhythm you want and the agent assembles a scene from the effect library.
Audio-reactive parameter binding
Number parameters can follow bass, mids, highs, loudness, kick, drop, energy or tempo.
Checked scene links
Built scenes are validated and return exact errors when a value needs changing before a link is given.
Local preview rendering
The preview tool renders a PNG frame or short MP4 on a synthetic beat to check the result.
No account or upload
Scenes live entirely inside the shareable link, and the server talks to no AVIZ service.

Good for

  • Generating a visual scene for a dark techno or electronic track from a chat prompt
  • Sharing a music visual as a single link that opens in the browser or AVIZ for Mac
  • Prototyping light show ideas by previewing frames before committing to a scene
  • Starting from ready-made templates and adjusting them to a track's tempo

Pricing

Open source

The MCP server runs locally from the npm package; no paid plan is mentioned.

Prices change. Check aviz.studio before you buy.

AVIZ FAQ

How do I install the server?

The site says it runs locally through npx with Node.js 22 or later. For Claude Code the command is claude mcp add aviz -- npx -y aviz-mcp, and other clients take an equivalent mcpServers entry.

Does ChatGPT work with AVIZ?

The site says ChatGPT connects only to remote servers, so using this server with ChatGPT currently needs a local bridge.

Are scenes uploaded anywhere?

The site says the server is local, talks to no AVIZ service, and that the scene travels after the # in the link, which browsers do not send to a server.

What is needed for previews?

Previews need Google Chrome, Chromium or Edge. Short MP4 previews also need ffmpeg.

Is AVIZ free?

Yes. AVIZ is open source, so you can use and self-host it for free.

How do I add AVIZ to Claude Code?

Run this command in your terminal: claude mcp add aviz-mcp -- npx -y aviz-mcp

What are the best alternatives to AVIZ?

The closest alternatives to AVIZ are Audio Studio, Vibresia, VibeCreator, Verse and Levea — Autonomous AI Video Editor (37 Tools, 280+ Caption Templates, OAuth 2.1).

Where this comes from

  • Description: written from the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers