Skip to main content
Glama

dreamsmith-song-mcp

An MCP music-making partner for FL Studio. The goal is to turn a feeling, memory, or high-level sound reference into an original arrangement and then shape it with you inside the DAW.

Dreamsmith uses references to guide broad choices such as pacing, space, texture, and emotional contrast. It does not copy a reference track's melody, recording, or lyrics.

v0.1 foundation

This first version provides:

  • Connection status, MIDI-port discovery, and a harmless FL Studio ping.

  • Project tempo and transport controls.

  • Mixer and Channel Rack inspection and selected controls.

  • Read/write access to parameters of plugins already loaded in FL Studio.

  • Piano Roll read, note-write, note-delete, and clear tools with input checks and explicit confirmation for destructive note operations.

  • MIDI and Piano Roll bridge scripts for macOS.

The FL Studio scripting API exposes separate MIDI-controller and Piano Roll script interfaces. Dreamsmith uses both: MIDI messages reach the controller script, while Piano Roll edits run through a .pyscript file. See docs/setup_macos.md.

Related MCP server: flai-mcp

Requirements

  • macOS for this initial bridge. Windows support is not implemented yet.

  • FL Studio 20.7 or later.

  • Python 3.10+ (3.12 recommended), uv, and the Xcode Command Line Tools.

  • macOS IAC Driver enabled and the FL Studio controller script selected.

Install

uv sync --python 3.12
./scripts/install_macos.sh

Then follow the steps in docs/setup_macos.md to enable the IAC MIDI input, choose the Dreamsmith controller, allow keyboard access for the Piano Roll bridge, and register the MCP server with Codex.

Important limits

  • Plugin parameters can be adjusted only after the user has loaded the plugin.

  • v0.1 does not create/select Playlist patterns or build a full Playlist arrangement; choose the target pattern in FL Studio first.

  • Piano Roll edits affect the currently focused Piano Roll. Read its state before editing. Replace, delete, and clear operations require explicit confirmation arguments.

  • This MCP controls FL Studio. It does not itself listen to or semantically decode audio. For sound-by-sound review, render or export audio and provide it in the conversation.

Codex configuration

See docs/codex-config.example.toml. After registration, restart Codex and call dreamsmith_status, then dreamsmith_ping.

Project status

Early alpha. FL Studio is not installed in the development environment used to create this initial version, so live MIDI and Piano Roll integration has not been exercised here. Connection errors are designed to explain what setup step is missing.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that connects AI assistants to FL Studio for music production via Virtual MIDI. It enables users to control transport, manage the mixer, write notes, and manipulate plugin parameters through natural language.
      1
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Gives AI assistants full control of FL Studio through its scripting API, enabling project editing, mixing, piano roll composition, MIDI export, and plugin automation without touching the mouse or keyboard.
      57
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI agent to compose and mix directly inside FL Studio: writing and clearing notes, setting tempo, levels and plugin parameters, inspecting what FL currently holds, checking which channels sound, and rendering the arrangement to WAV.
      3
      MIT