# SEGAN

> SEGAN is an open-source MCP server for design and media. Write game sound effects and music as YAML; lint, listen and build WAVs for Godot. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://segan.top
- **Repository:** https://github.com/lukasgolino/segan
- **MCP Registry name:** io.github.lukasgolino/segan
- **Categories:** design and media, games and play
- **Listing updated:** 2026-11-14

## About

The notation covers instrument kits, step-grid songs and layered synth sound effects, all in YAML. Because an agent cannot hear, the tool renders listen sheets, which are pictures of each sound with the numbers that matter, so the agent can check and fix its own work. Songs use roll rows that are the notes of the song's key, so an off-key note cannot be written.

Builds are deterministic: the same sources produce byte-identical WAVs, and every asset goes through one shared mix with loudness targets and a true-peak limiter. Output is WAVs, loop points, a manifest.json and Godot 4 resources. Sound effects include 11 presets such as coin, jump, laser and explosion; recorded sounds can be pulled from Freesound under CC0 and CC BY only, with attribution generated for CC BY. Sampled instruments and SoundFonts are supported, and MIDI import is available.

It is a Python package (segan-gen, Python 3.11 or newer) that runs offline with no account, and is the sister library of PAGAN for pixel art. It is Apache 2.0 licensed, at version 0.17.

## Features

- **Text notation for audio:** Kits, songs and SFX written as YAML.
- **Listen sheets:** Pictures of each sound an agent can inspect.
- **Lint with fix hints:** Findings carry rule id, file, line and a fix hint.
- **Godot-ready output:** WAVs, loop points, manifest.json and Godot resources.
- **Seamless loops:** Music patterns that loop cleanly.
- **Freesound integration:** Search CC0 and CC BY recordings and generate credits.
- **Deterministic builds:** Byte-identical output from identical sources.

## Good for

- Have an agent produce coin and jump sounds for a platformer
- Build a looping title theme
- Keep every sound on one loudness target
- Import a MIDI file into a game project
- Add attributed recorded sounds

## Install

### Claude Code (Terminal)

```sh
claude mcp add segan -- uvx segan-gen
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "segan": {
      "command": "uvx",
      "args": [
        "segan-gen"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "segan": {
      "command": "uvx",
      "args": [
        "segan-gen"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "segan": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "segan-gen"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "segan": {
      "command": "uvx",
      "args": [
        "segan-gen"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "segan": {
      "command": "uvx",
      "args": [
        "segan-gen"
      ]
    }
  }
}
```

## FAQ

### What engines does it target?

Godot 4 resources are generated, and WAVs plus a manifest work with any engine.

### Does it need an account or credits?

No; it runs locally and offline.

### Which Python version?

Python 3.11 or newer, installed with pip install segan-gen.

### Can it use recorded sounds?

Yes, from Freesound under CC0 and CC BY licenses only.

### Is SEGAN free?

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

### How do I add SEGAN to Claude Code?

Run this command in your terminal: claude mcp add segan -- uvx segan-gen

### What are the best alternatives to SEGAN?

The closest alternatives to SEGAN are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/segan
