Dreamsmith
by brunomattge
README.md
# 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`](docs/setup_macos.md).
## 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
```sh
uv sync --python 3.12
./scripts/install_macos.sh
```
Then follow the steps in [`docs/setup_macos.md`](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`](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.