MCP 服务器

DXN1-AUDIO-AI-TOOL

AI-powered music production toolkit enabling AI agents to generate, remix, separate stems, master tracks, and control DAWs via MCP.

README

DXN1-AUDIO-AI-TOOL

AI-powered music production toolkit. Generate music with Suno AI, remix in any DAW, separate stems, master, and more — all controllable by any AI agent (Claude, GPT, etc.) via MCP.

Install

# Clone the repo
git clone https://github.com/DXN1-termux/DXN1-DAW-AI-TOOL.git
cd DXN1-DAW-AI-TOOL

# Install dependencies
pip install -r requirements.txt

# (Optional) Install as a command-line tool
pip install -e .

That's it. dxn1 commands are now available.

Optional extras

# Stem separation (drums/bass/vocals/other) — needs GPU for speed
pip install demucs torch

# REAPER DAW control
pip install reapy

# Claude Vision (AI screenshot analysis of your DAW mixer)
pip install anthropic

# Suno AI music generation
pip install httpx

Set API keys (optional — local MIDI generation works without any keys)

export DXN1_SUNO_API_KEY="sk-..."

Quick Start

Generate music

# With Suno AI (needs API key)
dxn1 generate "Hardstyle banger with heavy distorted kicks at 150 BPM" --style hardstyle

# Without API key — generates a MIDI file locally
dxn1 generate "Dark trap beat" --local --bpm 140

# Generate MIDI only
dxn1 midi --root Am --scale NATURAL_MINOR --bpm 150 --bars 32 --genre hardstyle

Remix a song

# Analyze first
dxn1 analyze song.mp3

# Full remix (no DAW needed — pure audio processing)
dxn1 remix song.mp3 --style hardstyle --bpm 150

# Remix with DAW control (REAPER must be running)
dxn1 remix song.mp3 --style trap --backend reaper

# Separate stems first
dxn1 stem song.mp3

Master a track

dxn1 master track.wav --preset electronic
dxn1 master track.wav --preset hip_hop

Analyze audio

dxn1 analyze song.mp3
# → BPM: 128.0  Key: C minor  LUFS: -12.3  Duration: 3:42

Use with AI (Claude Desktop, etc.)

Add to your Claude Desktop config:

{
  "mcpServers": {
    "dxn1-audio-ai-tool": {
      "command": "python",
      "args": ["-m", "dxn1_audio_ai_tool.server.mcp_server"]
    }
  }
}

Then just tell Claude: "Make me a hardstyle remix of this song at 150 BPM" — it knows exactly what to do.

All Commands

Command	Description
`dxn1 generate "prompt"`	Generate music (Suno AI or local MIDI)
`dxn1 remix file.mp3 --style trap`	Full remix pipeline
`dxn1 analyze file.mp3`	Detect BPM, key, loudness, duration
`dxn1 stem file.mp3`	Split into drums / bass / vocals / other
`dxn1 master file.wav --preset modern`	Master a track (5 presets)
`dxn1 normalize file.wav --lufs -14`	Normalize to target LUFS
`dxn1 midi --bpm 150 --genre hardstyle`	Generate a MIDI arrangement
`dxn1 serve`	Start MCP server for AI agents
`dxn1 dashboard`	Open real-time web dashboard

MCP Tools (18 tools for AI agents)

AI Music Generation (Suno / Udio)

suno_generate — Generate a full song from text
suno_generate_custom — Custom lyrics with [Verse], [Chorus], [Drop] tags
suno_extend — Extend an existing generated track
suno_remix — AI-powered remix via Suno
generate_music — Auto-picks best provider (Suno → Udio → local MIDI)
generate_and_import — Generate music AND load it into a DAW

Audio Processing

analyze_audio — BPM, key, loudness, duration
separate_stems — Drums / bass / vocals / other via Demucs
normalize_audio — LUFS normalization
pitch_shift — Shift pitch by semitones
time_stretch — Change tempo without changing pitch
fade_audio — Add fade in / fade out

DAW Control

daw_connect — Connect to FL Studio / REAPER / Audacity / any DAW
remix_song — Full remix pipeline in one call

Mixing & Mastering

apply_mix_preset — Genre-balanced mix (9 genres)
list_mix_presets — List all available presets
master_audio — Full mastering chain (EQ → compression → limiting → LUFS)

Local Generation (no API key needed)

generate_midi — Complete MIDI song: chords, melody, bass, drums

Supported DAWs

DAW	Cost	Controller	Best For
REAPER	Free trial / $60	reapy Python API	All genres, all platforms
FL Studio	$99+	pywinauto + MIDI Script	Electronic music, Windows
Audacity	Completely free	Keyboard automation	Basic editing, all platforms
Any DAW	—	Generic keyboard shortcuts	Quick tasks

Environment Variables

Variable	Default	Description
`DXN1_SUNO_API_KEY`	—	Suno AI API key
`DXN1_UDIO_API_KEY`	—	Udio API key
`DXN1_FL_EXE_PATH`	—	FL Studio executable path
`DXN1_OUTPUT_DIR`	`./output`	Output directory
`DXN1_SERVER_TRANSPORT`	`stdio`	MCP transport (stdio / sse)
`DXN1_VISION_ANTHROPIC_API_KEY`	—	Claude API for vision QC

Project Structure

dxn1_audio_ai_tool/
├── audio/engine.py              # Analysis, stem separation, normalize, pitch, stretch
├── services/
│   ├── suno_client.py           # Suno AI — generate, extend, remix
│   ├── udio_client.py           # Udio AI — generate, extend
│   └── ai_music_client.py       # Unified client (auto-pick provider)
├── controllers/
│   ├── base.py                  # Abstract DAW interface
│   ├── fl_studio.py             # FL Studio (pywinauto + MIDI Script)
│   ├── reaper_controller.py     # REAPER (reapy)
│   ├── audacity_controller.py   # Audacity (keyboard automation)
│   └── generic_daw.py           # Any DAW (keyboard shortcuts)
├── pipeline/remix.py            # Full remix orchestration
├── generation/midi_generator.py # Algorithmic MIDI songs
├── mixing/presets.py            # 9 genre mix presets
├── mastering/chain.py           # Offline mastering (EQ/comp/limit/LUFS)
├── vision/agent.py              # Claude Vision screenshot analysis
├── feedback/
│   ├── dashboard.py             # Real-time web dashboard
│   ├── overlay.py               # Cursor tracking + screenshot annotation
│   └── action_log.py            # Action history
├── server/
│   ├── mcp_server.py            # 18 MCP tools for AI agents
│   └── system_prompt.py         # System prompt that teaches AI how to use tools
├── cli.py                       # One command for everything
├── config.py                    # All settings + env var support
└── utils.py                     # Logging, timing, helpers