Postfader

为你的 AI 助手赋予 FL Studio 中的眼睛和双手

探索你已打开的项目、进行经过仔细核验的更改，并比较导出的混音——全部通过兼容 MCP 的 AI 客户端完成。

功能特性 · 兼容的 AI 客户端 · 快速开始 · 支持的版本 · 安全设计 · 文档

[!NOTE] Postfader 是一个非官方社区项目。它并非由 Image-Line 制作，也与 Image-Line 无关联。

Postfader 通过一个小型控制器脚本将本地 AI 客户端连接到 FL Studio。你可以询问当前项目相关问题、更改受支持的控件、试听一个音符，或测量音频文件，而无需构建自定义的 FL Studio 集成。

它包含 37 个聚焦的工具：

• 12 个用于读取已打开的 FL Studio 项目的工具；

• 19 个用于更改受支持的项目设置并核验结果的工具；

• 一个会话控制工具，用于在不重启 FL Studio 的情况下启用或禁用这些更改；

• 一个短时实时音符试听工具；以及

• 四个用于分析导出音频文件的工具。

兼容的 AI 客户端

Postfader 与模型和厂商无关。它使用标准的本地 stdio MCP 传输，因此可与任何能够启动本地进程的、兼容 MCP 的桌面或编码客户端配合使用。

此兼容性适用于能够在与 FL Studio 同一台计算机上启动 Postfader 的本地客户端。仅浏览器端的聊天界面需要先拥有自己的本地 MCP 或插件运行时才能连接。

Related MCP server: FL Studio MCP Server

你可以做什么

Postfader 还可以检查和控制在 FL 原生效果器、VST/VST3/AU 效果器以及 Channel Rack 发生器上暴露的参数。插件支持是在运行时从 FL Studio 中发现的，而非局限于固定列表。

示例请求

“Show me every used mixer track and where it routes.”

“Which Channel Rack instruments are not assigned to a mixer insert?”

“Rename insert 4 to Lead Vocal, set its pan to 10% left, and confirm both changes.”

“Set the tempo to 128 BPM while the project is stopped.”

“Enable write mode for this session, then rename insert 4 to Lead Vocal.”

“Compare my latest bounce with the reference and summarize the loudness,
stereo, dynamics, and frequency-band differences.”

为什么使用 Postfader？

• 保持创作流畅。 无需在多个 FL Studio 窗口中翻找，即可询问项目信息或进行常规更改。

• 知道更改是否生效。 Postfader 在更改受支持的控件后会读回该控件，并报告更改前状态、更改后状态和结果。

• 安全起步。 Postfader 以只读模式连接。当你准备好时，请你的 AI 客户端为当前会话启用写入——无需重启 FL Studio。

• 使用你已有的插件。 Postfader 发现 FL Studio 暴露的参数表面，而不是要求为每个插件提供自定义配置文件。

• 保持本地化。 Postfader 没有托管服务、账户、遥测或项目上传步骤。

“已验证”的含义

对于受支持的更改，Postfader：

1. 检查目标、值、当前会话以及任何提供的更改前状态；

2. 请求 FL Studio 进行更改；

3. 等待后续的 FL Studio 更新并再次读取该控件；以及

4. 报告请求的状态是否确实被观察到。

这可以捕获一种常见的自动化失败：FL Studio 或插件接受了命令但忽略了该值。

[!IMPORTANT] 已验证的结果意味着该控件在请求的设置下被观察到。这并不意味着音乐上的选择听起来很好。写入会立即影响已打开的项目，并且不会自动回滚。Postfader 永远不会替你保存项目。

工作原理

flowchart LR
    A["Your AI client<br/>(MCP)"] --> B["Postfader<br/>runs locally"]
    B -->|"Virtual MIDI"| C["Universal Bridge<br/>inside FL Studio"]
    C --> D["Your open project"]
    B -->|"Files you choose"| E["Exported audio<br/>measurements"]

MCP 是让 AI 客户端调用 Postfader 命名工具的连接方式。实时 FL Studio 通信通过一个本地虚拟 MIDI 端点进行。音频分析从磁盘读取导出的文件，因为 FL Studio 的脚本 API 不提供实时音频缓冲区。

支持的版本

Python 3.13/3.14 和 Windows ARM64 可能需要原生编译器来编译 python-rtmidi。当前的 Windows CI 在 x64 上运行。

快速开始

1. 准备一个虚拟 MIDI 端点

• macOS： 在 Audio MIDI Setup 中启用一个 IAC 总线。

• Windows： 使用你选择的虚拟 MIDI 软件创建一个双向端点。

Postfader 不会安装或配置虚拟 MIDI 软件。你将使用同一个端点作为 FL Studio 的 MIDI 输入和输出。

在安装 Postfader 之前先启动一次 FL Studio，以便它创建用户数据文件夹，然后退出 FL Studio。

2. 安装 Postfader

macOS

git clone https://github.com/synopsys0/postfader-fl-studio-mcp.git
cd postfader-fl-studio-mcp
./scripts/install.sh

Windows PowerShell

git clone https://github.com/synopsys0/postfader-fl-studio-mcp.git
Set-Location postfader-fl-studio-mcp
.\scripts\install.ps1 -DryRun
.\scripts\install.ps1

安装程序会创建一个本地 .venv，安装 Postfader，并将 Universal Bridge 复制到 FL Studio 的控制器脚本文件夹中。它们不会更改你的 AI 客户端配置。

你也可以安装已发布的 Python 包：

pip install postfader-fl-studio-mcp
postfader-install-bridge

3. 连接 FL Studio

在 FL Studio 中打开 Options → MIDI settings：

1. 在 Input 下启用你的虚拟端点。

2. 将其控制器类型设置为 Universal Bridge。

3. 为该输入指定一个 FL Studio Port 编号。

4. 在 Output 下启用同一个端点，并为其指定相同的 Port 编号。

5. 打开 View → Script output 并重新加载脚本。

脚本应报告 ready: MIDI SysEx。

4. 检查连接

macOS

./.venv/bin/postfader-doctor --midi-port "IAC Driver Bus 1" --json

Windows PowerShell

.\.venv\Scripts\postfader-doctor.exe --midi-port "Exact Virtual MIDI Endpoint Name" --json

健康的连接会报告：

• overall: "pass"；

• 一个实时的 FL Studio 连接；

• 一个与已安装的 Postfader 版本匹配的控制器脚本；

• bridge_mode: "read_only"；以及

• verified_writes_enabled: false；以及

• runtime_write_mode_control: true。

5. 将 Postfader 添加到你的 AI 客户端

使用附带的配置生成器，以便解释器路径、仓库路径和端点名称明确无误：

./.venv/bin/python scripts/generate_mcp_config.py --help

.\.venv\Scripts\python.exe scripts\generate_mcp_config.py --help

它可以生成 Codex 命令、Codex TOML 或标准的 mcpServers JSON，供 Claude 兼容客户端、Cursor 和许多其他 MCP 客户端使用。请参阅客户端配置指南获取完整的 macOS 和 Windows 示例。

Claude Desktop 用户可以打开发布的 .mcpb 文件，但该扩展不会安装 FL Studio 控制器脚本或创建虚拟 MIDI 端点。请先完成步骤 1–4。

安全设计

只读模式

正常的 FL Studio 启动会让 Postfader 保持只读：项目检查可以工作，但更改项目的工具不可用。音频文件分析也可以在无实时 FL Studio 连接的情况下工作。这是探索真实会话的推荐模式。

写入模式

当你希望 Postfader 进行更改时，请向你连接的 AI 客户端提出请求：

“Enable write mode for this session.”

你的客户端会调用 fl_set_write_mode，并且必须携带明确的、用户在场的确认。Postfader 随后会检查正在运行的控制器脚本，仅更改该实时会话，并在报告写入可用之前执行第二次握手。FL Studio 无需重启。

完成后请让客户端“禁用写入模式”。该设置永远不会存储在你的项目或 AI 客户端配置中，普通的控制器脚本重新加载或新的 FL Studio 进程会再次以只读模式启动。首次尝试写入时请使用空白或一次性项目。

其他安全措施包括：

• 启用写入需要明确的用户请求，并作为破坏性能力变更暴露给 MCP 客户端；

• 对 Master 音轨的写入需要明确许可；

• 如果已安装的控制器脚本与 Postfader 版本不匹配，写入将被阻止；

• 在响应丢失或含糊不清后，写入绝不会自动重试；

• 提供的会话和写入前状态检查可以拒绝过时的决策；

• 同一时间只有一个本地 Postfader 连接可以使用选定的虚拟 MIDI 总线；以及

• 控制器脚本从不调用 FL Studio 的保存项目功能。

有关每个写入工具的确切行为，请参阅工具契约。

插件支持

Postfader 可以与任何 FL Studio 向控制器脚本公开参数的混音器效果器或 Channel Rack 发生器配合使用。这包括原生 Image-Line 插件以及许多 VST、VST3 和 AU 插件。

兼容性是有意保持诚实的：

• 可以在不先将插件添加到 Postfader 的情况下检查不熟悉的插件；

• FL 未公开的参数无法被控制；

• 非常大的参数映射会以明确的限制进行扫描；

• FL 接受但忽略的写入会被报告为未验证；以及

• 命名选项必须使用 FL Studio 报告的精确标签，忽略大小写。

有关参数发现、选项搜索、扫描限制、故障排除和社区证据格式，请参阅插件支持。

重要限制

Postfader 目前无法：

• 添加、删除或重新排序插件；

• 可靠地控制效果器插槽的旁通或干/湿混合；

• 听到 FL Studio 的实时输出；

• 渲染、导出或保存项目；

• 判断混音听起来是否好听；或

• 将原始 Playlist 选区端点转换为安全的自动渲染范围。

音频工具分析你明确选择的文件或在有界的 FL Studio 文件夹中找到的最近导出的音频。它们返回测量值和比较结果，而不是音频样本或艺术判断。

本地虚拟 MIDI 总线是共享且未经身份验证的。请在受信任的单用户工作站上使用 Postfader。

隐私

Postfader 本身在本地运行，没有遥测或云服务。它不会在此仓库中存储你的项目、录音、分轨、预设、导出或实时会话证据。

你的 AI 客户端是独立的应用程序，可能会将工具参数和结果发送给其模型提供商。音频结果可能包含文件路径、哈希值和测量值，但绝不会包含音频样本。在使用敏感项目之前，请查看你的 AI 客户端的隐私政策和 Postfader 的安全政策。

文档

开发

从源代码检出运行安全、无需硬件的测试套件：

./.venv/bin/python scripts/run_safe_tests.py

.\.venv\Scripts\python.exe scripts\run_safe_tests.py

即使环境变量请求真实 MIDI 访问，安全套件也会阻止它。任何实时硬件测试都必须使用空白、未保存的项目，并且其日志、截图和运行记录必须保留在公共仓库之外。

许可证

Postfader 在 Apache License 2.0 下可用。有关署名详情，请参阅 NOTICE。