FlMCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
FlMCP — MCP-сервер для FL Studio
Управление FL Studio из MCP-клиента (opencode, Claude Desktop, Cursor, ...). Внутрь
FL Studio ставится небольшой скрипт MIDI-контроллера, сервер общается с ним по
локальному TCP (127.0.0.1:7777), а скрипт выполняет код прямо в FL — в том же
интерпретаторе, где живёт всё её scripting API. Поэтому доступно всё, что FL открывает
своим скриптам: транспорт, микшер, каналы, плагины, паттерны, плейлист, окна, undo.
Что умеет
Инструмент | Что делает |
| Выполняет любой Python в FL Studio и возвращает результат в JSON: |
| То же, но переменные живут между вызовами — удобно, когда работа идёт в несколько шагов. |
| Справка по API этой версии FL: модули, сигнатуры, полные докстринги, вытащенные из живой FL Studio. |
| Снимок проекта одним куском: версия, темп, позиция, паттерны, каналы, микшер с плагинами, треки плейлиста, открытые окна. |
| Пишет ноты в piano roll выбранного канала ( |
| Открывает окно (микшер, плейлист, piano roll, браузер, channel rack) или нажимает пункт меню: |
| Шпаргалка без обращения к FL: инструменты, как писать код, подводные камни API, рецепты. |
| Скриншот окна FL Studio. |
Related MCP server: flstudio-mcp-mac
Требования
Windows и FL Studio 20.8+ (проверено на FL Studio 2026).
Python 3.10+ с пакетами
mcpиpillow.Виртуальный MIDI-порт, например loopMIDI. Скрипт-мост загружается как MIDI controller script, а этот тип скриптов FL Studio вешает только на MIDI-вход, без порта его просто не видно в списке.
Установка
cd F:\FlMCP\FlMCP
py -3.11 -m pip install -r requirements.txt
.\install.ps1install.ps1 кладёт в Documents\Image-Line\FL Studio\Settings\Hardware набор файлов с
одним и тем же именем FlMCP:
device_FlMCP.py— собственно скрипт-мост (плюсhelpers.pyрядом);FlMCP.ini— файл настроек;FLMCP.zip— тот же комплект архивом.
FL Studio ищет MIDI-контроллер именно так — по паре device_<имя>.py + <имя>.ini, и
имена должны совпадать до буквы. Если папка называется FLMCP, а device_FlMCP.py +
FlMCP.ini лежат внутри — FL молча пропускает её, и ни в списке, ни в логах ничего не
появляется. В списке Controller type устройство называется FlMCP (имя из заголовка
# name= внутри скрипта).
Скрипт piano roll (FLMCP_Write.py) уезжает в Settings\Piano roll scripts, с уже
подставленными путями. Если папка FL Studio перенесена, добавьте -FlUser "D:\FL Studio".
Дальше в FL Studio:
Создайте порт в loopMIDI и перезапустите FL Studio.
Options → MIDI settings → INPUT: включите Enable у порта, в поле Controller type выберите FlMCP (там же, где
AKAI FL Studio Fire,Novation FLkey, ...).Проверка на живом FL Studio:
py -3.11 tests/live.smoke.py.
Если FL Studio не грузит скрипт, он молчит: в окне настроек остаётся тот же список, а
порт 7777 закрыт. Тогда смотрите FLMCP_load.txt в Settings\Hardware рядом со
скриптом — он пишет время импорта или traceback и появляется только после того, как
FL запустил контроллер.
Сразу после этого лучше сделать fl_project — если ответ пришёл, мост жив, и можно
идти дальше. Перезапускать FL Studio нужно только после правки скриптов на диске.
Если раньше в FL Studio стоял старый fl-studio-mcp (karl-andres), его папка и
служебные JSON остаются лишними. Их убирает
py -3.11 tools/clean_old_mcp.py --yesТам есть и мелочи для отладки: tools/fl_log.py ищет в логах FL Studio строки про
FlMCP, tools/fl_click.py жмёт пункт меню через живой мост.
Запуск
Сервер — обычный stdio MCP-сервер: py -3.11 server.py.
opencode (opencode.json):
"fl-studio": {
"type": "local",
"command": ["py", "-3.11", "F:/FlMCP/FlMCP/server.py"],
"enabled": true
}Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"fl-studio": {
"command": "py",
"args": ["-3.11", "F:/FlMCP/FlMCP/server.py"]
}
}
}Порт моста меняется переменной окружения FLMCP_PORT (по умолчанию 7777) — и у
сервера, и у скрипта-моста.
Примеры
# что открыто
[ui.getVersion(4), ui.getProgTitle(), mixer.getCurrentTempo()]
# темп и транспорт
mixer.setCurrentTempo(128.0)
transport.setSongPos(16 * midi.PPQ) # 16-й такт
transport.start()
# громкость всех каналов на 70%
for i in range(channels.channelCount()):
channels.setChannelVolume(i, 0.7)
# параметр 3 плагина в первом слоте инсерта 1 на 50%
plugins.setParamValue(0.5, 3, 1, 0)
# плейлист и микшер
playlist.setTrackName(0, "drums")
[mixer.getTrackName(i) for i in range(8)]# ноты в piano roll выбранного инструмента
fl_piano_roll([(60, 0, 96, 100), (64, 96, 96, 90), (67, 192, 192, 80)])Про API FL Studio стоит помнить пару вещей:
порядок аргументов местами необычный:
plugins.setParamValue(value, paramIndex, index, slotIndex, pickupMode, useGlobalIndex),plugins.getPluginName(index, slotIndex, userName, useGlobalIndex),channels.setChannelVolume(index, volume, pickupMode, useGlobalIndex);каналы (
channels.*) и микшер (mixer.*) нумеруются отдельно;цвета FL хранит как
0xBBGGRR— вhelpersестьhelpers.rgb(r, g, b)иhelpers.color(value);код выполняется в потоке интерфейса FL Studio, поэтому бесконечный цикл положит не только сервер, но и саму FL Studio.
Ограничения
Плагины нельзя загрузить через API — ни VST, ни встроенные. Их добавляют через меню:
fl_windowумеет нажимать пункты, но выбор нужного плагина в длинном списке надёжнее сделать руками.Ноты piano roll нельзя прочитать из MIDI controller script, FL даёт к ним доступ только скриптам piano roll. Запись идёт через связку: контроллер кладёт задание рядом с
FLMCP_Write.py, нажимает пункт меню, FL запускает скрипт между кадрами, ответ приходит файлом на следующем кадре. Читать ноты можно в самом скрипте piano roll, но не изfl_eval.Скрипт-мост перезагружается вместе с FL Studio: после правки
device_FlMCP.pyилиhelpers.pyFL нужно перезапустить.Скриншот: FL Studio рисует через GPU, и
PrintWindowможет вернуть чёрный кадр. Тогда сервер снимает экран и выводит окно на передний план — в этот момент окно не должно быть перекрыто.fl_evalиfl_repl— это произвольный код в FL, ограничений по API нет; если код завис, до перезапуска FL Studio отвечать будет некому.Не все версии FL Studio одинаковы: то, что было в 20.8, в 2026 могло отрасти новыми аргументами.
fl_apiпоказывает именно вашу версию.
Самопроверки
Требует запущенной FL Studio только последний:
py -3.11 tests/controller.selfcheck.py # скрипт-мост против фейкового FL API (сокет + OnIdle)
py -3.11 tests/server.selftest.py # инструменты MCP против фейкового контроллера
py -3.11 tests/stdio.py # MCP-протокол: handshake, tools/list, tools/call
powershell -File tests/capture.selfcheck.ps1 # PrintWindow на живом окне (блокнот)
py -3.11 tests/live.smoke.py # живой FL Studio: всё по кругуФайлы
server.py MCP-сервер: TCP-мост с таймаутами, инструменты, скриншот окна
controller/device_FlMCP.py скрипт MIDI-контроллера для FL Studio: сокет, фоновые задания
controller/helpers.py удобства для fl_eval и piano roll, нажатия меню
controller/FLMCP_Write.py скрипт piano roll: пишет ноты по заданию
install.ps1 раскладывает скрипты по папкам FL Studio
tests/ самопроверки без FL Studio и живой смоук-тест
tools/ чистка следов старого mcp, логи, нажатия меню
assets/banner.svg шапка READMEЛицензия
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
OSC ↔ MIDI bridge for synthesizers and DAWs, with the SynthHub catalogue. A MIDI MCP and OSC MCP.
Connect any MCP client to MetaTrader 4/5 to read prices, manage positions, and place trades.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables remote control and automation of FL Studio via the flapi Python client. It provides tools for managing transport, mixer tracks, pattern sequencing, and plugin parameters, allowing users to execute Python code directly within the FL Studio environment.2-
- AlicenseNot gradedqualityDmaintenanceEnables controlling FL Studio on macOS via MCP, including transport, mixer, channel, MIDI export, and Piano Roll note insertion.16 PyPIMIT
- FlicenseNot gradedqualityDmaintenanceEnables MCP-compatible chat to control FL Studio on Windows, including transport, BPM, channels, mixer, patterns, and note insertion via MIDI bridge.-
- AlicenseCqualityCmaintenanceEnables end-to-end control of FL Studio on macOS through MCP clients, including transport, patterns, mixer, piano roll, playlist, live metering, browser navigation, and rendering.160MIT