AVIZ
MCP server that lets AI agents build audio-reactive music visual scenes as shareable links
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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"aviz-mcp": {
"command": "npx",
"args": [
"-y",
"aviz-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"aviz-mcp": {
"command": "npx",
"args": [
"-y",
"aviz-mcp"
]
}
}
}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.