Skip to content
MCP server

Fyug

Generative music composition and live playback for you and your AI agent

Runs locallyStatus and history
Install
Platforms
macOS, Linux, Windows
Runs
Locally
Version
2026.11.2
Listing updated
today

About Fyug

Fyug is an MCP server for music creation. It runs locally on your machine and is started by your AI client.

The README says Fyug lets a person and an AI agent build generative music together and hear the result play back as each change is made. It is delivered as a command line tool, an audio engine and an MCP server that can be registered with several local AI clients.

Setup is handled by a fyug setup command, which looks for Claude Code, Codex, Claude Desktop and Cursor on the machine and adds the fyug-mcp server to each one's configuration. A preview mode prints the intended changes without writing them. Installers and bundles are provided for macOS, Linux and Windows, and the README notes that the installer verifies downloads against a published SHA256 checksum file.

The project is described as built on the open-source Fugue engine. It suits people who want to sketch music through conversation with an agent and listen as the patch changes.

Install

Run in a terminal

claude mcp add fyug -- npx -y https://github.com/Ilusiv-media/fyug/releases/download/v2026.11.2/fyug-2026.11.2-aarch64-apple-darwin.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "fyug": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ilusiv-media/fyug/releases/download/v2026.11.2/fyug-2026.11.2-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "fyug": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ilusiv-media/fyug/releases/download/v2026.11.2/fyug-2026.11.2-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "fyug": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ilusiv-media/fyug/releases/download/v2026.11.2/fyug-2026.11.2-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "fyug": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ilusiv-media/fyug/releases/download/v2026.11.2/fyug-2026.11.2-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "fyug": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ilusiv-media/fyug/releases/download/v2026.11.2/fyug-2026.11.2-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}

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

What it does

Live generative playback
Changes to a composition are heard as they are made, according to the README.
Agent-driven composition
An AI agent can compose music through the Fyug MCP server alongside a person.
One-command client setup
The fyug setup command registers the server with supported local AI clients.
Setup preview mode
Running fyug setup with the print flag shows the exact configuration changes before writing them.
Checksum-verified installer
The installer refuses to proceed if a release checksum is missing or does not match.
Multiple install routes
Installation is available through a shell script, PowerShell, a Claude Desktop bundle, Homebrew and a macOS app.

Good for

  • Sketching generative music by describing ideas to an AI agent
  • Hearing agent-made changes to a musical patch in real time
  • Experimenting with generative music without writing audio code
  • Adding a music tool to Claude Code, Codex or Cursor

Fyug FAQ

How do I add Fyug to my AI client?

The README says to run fyug setup, which adds the fyug-mcp server to detected clients such as Claude Code, Codex, Claude Desktop and Cursor, then restart the agent.

Which platforms are supported?

The README lists macOS on Apple silicon, Linux with glibc on x86_64 and arm64, and Windows on x86_64.

Is Fyug built on other software?

The README says Fyug is built on the open-source Fugue engine.

How do I add Fyug to Claude Code?

Run this command in your terminal: claude mcp add fyug -- npx -y https://github.com/Ilusiv-media/fyug/releases/download/v2026.11.2/fyug-2026.11.2-aarch64-apple-darwin.mcpb

Where this comes from

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

How AIPoweredBot checks servers