# Fyug

> Fyug is an MCP server for music creation. Generative music composition and live playback for you and your AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** macOS, Linux, Windows, CLI
- **Repository:** https://github.com/ilusiv-media/fyug
- **MCP Registry name:** fm.fyug/fyug
- **Categories:** music creation
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## 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.

---
Source: https://ai-powered.com/mcp/fyug-2
