Fyug
Generative music composition and live playback for you and your AI agent
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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.