mcpField
P
PostFader

PostFader

本地服务
github.com/synopsys0媒体与设计93 周前更新

关于 PostFader

PostFader 是本地 MCP 服务,可让 AI 客户端检查和编辑已打开的 FL Studio 项目。它默认只读,会核验支持的修改,并分析导出的音频而非实时输出。

主要功能

  1. 01检查混音器、通道、模式和插件
  2. 02编辑会话设置及插件参数
  3. 03生成 MIDI 并写入钢琴卷帘
  4. 04分析导出混音并对比参考音频
  5. 05执行可续接且经核验的制作计划

适用场景

  1. 01查找项目中的路由或插件问题
  2. 02通过 AI 客户端调整混音器设置
  3. 03创作低音线、和弦、旋律或鼓组
  4. 04检查导出混音的平衡与人声遮蔽

MCP 相关

向 MCP 客户端提供 FL Studio 项目检查、编辑、MIDI 和音频分析工具及资源。它通过虚拟 MIDI 端口和 Universal Bridge 在本机连接。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"synopsys0-postfader-fl-studio": {
"command": "uvx",
"args": [
"postfader-fl-studio-mcp"
],
"env": {
"FL_BRIDGE_ENABLE_MIDI": "<FL_BRIDGE_ENABLE_MIDI>",
"FL_BRIDGE_MIDI_PORT": "<FL_BRIDGE_MIDI_PORT>",
"FL_STUDIO_USER_DATA_DIR": "<FL_STUDIO_USER_DATA_DIR>"
}
}
}
}
启动命令uvx postfader-fl-studio-mcp
需要配置的环境变量
FL_BRIDGE_ENABLE_MIDISet to 1 to build the MIDI SysEx transport. Without it the server cannot reach FL Studio.
FL_BRIDGE_MIDI_PORTExact virtual MIDI endpoint name shared with FL Studio. PostFader does not install or configure a virtual MIDI provider.
FL_STUDIO_USER_DATA_DIRAbsolute FL Studio user-data directory containing Settings/Hardware.

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypipostfader-fl-studio-mcp12.0.3

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

PostFader,FL Studio MCP 服务

PostFader:FL Studio MCP 服务

让 Claude、Codex、Cursor 或任何 MCP 客户端在你当前打开的 FL Studio 工程中工作。

Latest release PyPI Python Platforms CI License

下载 Windows 版 下载 macOS 版

快速开始 · 功能介绍 · 为什么选择 PostFader · 文档 · 常见问题

免费且开源。非官方项目:并非由 Image-Line 制作,也与 Image-Line 无关。


PostFader 是一款 FL Studio MCP 服务。它将你的 AI 助手连接到你已经打开的工程,让 AI 可以读取混音器、通道、插件和模式,检查导出的混音,编写 MIDI 并替你进行修改。每项受支持的修改都会从 FL Studio 中读回,因此你能看到实际发生了什么。

它运行在你的电脑上。无需 PostFader 账户,也不使用云服务或遥测。

你可以提出的需求

向 AI 提问PostFader 的功能
🔎 了解工程“哪些乐器没有路由到混音器?”读取路由、效果器、通道、模式、Playlist 音轨和插件参数。
🩺 修复混音“这份弹出文件里最大的问题是什么?列出 3 个。”测量你导出的文件中的响度、峰值、音调平衡、立体声宽度和人声遮蔽,并与参考音频进行比较。
🎛️ 修改会话“把背景人声的声像拉宽,并将混响发送电平下调 3 dB。”设置推子、声像、发送、路由、名称、颜色、速度、播放控制,以及已加载插件公开的任意参数,然后逐项读回。
🎹 创作音乐“在我的和弦下方加一条 8 小节的 D 多利亚调式贝斯线。”生成和弦、旋律、贝斯线和鼓点;将它们写入钢琴卷帘,或导出 MIDI 文件。
🎚️ 挑选音色“从已加载的音色中自行挑选。”为工程中的乐器挑选预设,并确认每项选择。
🧱 完成整项任务“把这个循环扩展成 16 小节的初稿,但保留我的人声。”将任务作为可检查、可继续执行的计划运行。导出一份混音后,它可以检查初稿并规划一次修改。

在工具参考中浏览全部 85 个工具。

快速开始

你需要: Windows 或 macOS 上的 FL Studio 2026(26.1.3 或更高版本)、 Python 3.10 至 3.14,以及一个虚拟 MIDI 端口:macOS 内置的 IAC Driver,或 Windows 上免费的应用,例如 loopMIDI。

  1. 运行安装程序。 从最新版本下载 Windows 或 macOS ZIP 文件,解压后运行其中的安装程序。它会安装 PostFader、将桥接脚本复制到 FL Studio,并询问要使用哪个 MIDI 端口。
  2. 在 FL Studio 中, 打开 Options → MIDI settings。将虚拟端口同时启用为输入和输出,将输入的控制器类型设为 Universal Bridge,并为输入和输出设置相同的端口编号。
  3. 连接你的 AI 客户端, 使用安装程序打印的配置(参见 兼容的客户端)。
  4. 先提一个问题, 例如 “总结我的项目。” PostFader 初始为只读模式,因此在你要求编辑之前不会有任何更改。

直接使用 Python?运行 pip install postfader-fl-studio-mcp,然后运行 postfader setup。设置指南介绍了所有选项,而 postfader-doctor 则会精准指出未连接的部分。

工作原理

你的 AI 客户端在电脑上与 PostFader 通信;PostFader 通过虚拟 MIDI 端口连接 FL Studio 内的 Universal Bridge 脚本;该桥接脚本读取并修改你打开的项目。PostFader 会直接分析导出的音频。

FL Studio 只会运行其内部的脚本,因此 PostFader 会通过虚拟 MIDI 端口与一个小型控制器脚本 Universal Bridge 通信。音频分析针对你导出的文件进行,因为 FL Studio 不会向脚本提供实时输出。

为什么选择 PostFader

  • 只有在你提出要求后才会发生更改。 PostFader 初始为只读模式。编辑需要启用写入模式,AI 只有在你要求更改时才会为当前会话开启此模式。重新加载项目后,写入模式会再次关闭。
  • 更改会经过核验,而非凭空假定。 每次支持的编辑后,PostFader 都会从 FL Studio 读取修改后的值,并报告实际结果。
  • 不会替你保存项目。 你来决定何时保存,而且 FL Studio 的撤销历史记录会继续生效。
  • 检查的是混音效果,而不只是设置。 Mix Doctor、响度和真峰值检查、参考对比以及人声遮蔽分析,都会针对你选择的混音导出文件运行。
  • 不会挤占 AI 的上下文空间。 只有 AI 需要时才会加载详细的计划格式,为你们的对话留出空间。
  • 已在 Windows 和 macOS 上测试。 每次发布前,都会在这两个系统上运行完整的测试套件。

查看 PostFader 与其他 FL Studio MCP 服务的比较 →

兼容的客户端

PostFader 是本地 MCP 服务,因此你的 AI 客户端必须与 FL Studio 在同一台电脑上运行。postfader setup 会打印可直接粘贴的配置。

客户端连接方式
Claude Desktop粘贴生成的 claude-json 配置,或从发布页面安装 .mcpb 扩展。
Claude Codeclaude mcp add-json fl-studio '<the fl-studio entry from claude-json>'
Codex(命令行、IDE、应用)运行 Codex 安装程序 ZIP,或运行 postfader setup --client codex-toml --register-codex。
Cursor将 claude-json 条目粘贴到 ~/.cursor/mcp.json。
其他 MCP 客户端任何能够启动本地 stdio 服务的客户端。使用相同的命令、参数和环境变量。

文档

指南内容
设置与故障排除安装程序、MIDI 设置、各类客户端、升级和 doctor
工具参考按任务分类的全部 85 个工具和 8 个资源
常见问题常见问题和故障的简短解答
对比PostFader 与其他 FL Studio MCP 服务及 Gopher 的对比
制作流程多步骤任务、恢复和停止
创作审核审核初版混音、修改并准备交付
音色选择PostFader 如何从已加载的乐器中选择预设
插件支持参数控制、预设和兼容性报告
FL Studio 的限制FL Studio 的脚本 API 无法实现的功能
安全与隐私各项功能的运行位置,以及如何报告漏洞
所有文档架构、契约、发行说明等

常见问题

什么是 FL Studio MCP 服务?

MCP(Model Context Protocol)是 AI 助手用来调用工具的开放标准。FL Studio MCP 服务为助手提供 FL Studio 工具,使其能够读取和更改你的项目,而不只是描述要点击什么。

哪些 FL Studio 版本可用?

FL Studio 2026,版本 26.1.3 build 5336 或更高版本。较旧的版本缺少 PostFader 所依赖的 MIDI 脚本修复,因此无法使用。

我需要 loopMIDI 吗?

在 Windows 上,你需要一个虚拟 MIDI 端口;loopMIDI 是常见的免费选择。在 macOS 上,请在“音频 MIDI 设置”中启用内置的 IAC Driver。

它能听到我的歌曲吗?

它可以分析你导出的音频文件。FL Studio 不会让脚本访问其实时输出,因此 PostFader 无法实时监听。

它能加载插件吗?

在 macOS 上可以:它会通过 FL Studio 的“添加”菜单添加乐器和效果器(这需要“辅助功能”权限)。在 Windows 上,请自行加载插件;之后 PostFader 即可控制其参数。

它会弄乱我的项目吗?

它以只读模式启动,会检查每项受支持的更改,并且绝不会保存。如果你不喜欢某项编辑,可以使用 FL Studio 的撤销功能;首次编辑时建议使用副本。

更多内容请参阅常见问题。

贡献与安全

欢迎提交错误报告、插件兼容性结果和拉取请求;请参阅 CONTRIBUTING.md 和 GitHub 讨论区。 请按照 SECURITY.md 中的说明私下报告漏洞。

PostFader 根据 Apache License 2.0 授权。FL Studio 是 Image-Line 的商标;Image-Line 未参与制作或认可本项目。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。