FL Studio x AI MCP 连接指南

通过 MCP 协议让 AI Agent 直接控制 FL Studio，实现 AI 辅助音乐制作
up已对线生活，创作音乐似乎是很久远的事了，希望该教程能帮助到各位艺术家们，尽情享受创作！

🎵 FL Studio 🤖 Claude CLI 🔗 MCP Protocol 🎹 MIDI 控制 ⏱ ~15 分钟

🏗 架构概览

整个连接链路：Claude Agent 通过 MCP 协议与 FL Studio MCP 服务端通信，FL Studio 通过虚拟 MIDI 端口接收控制指令。

🤖 Claude Agent
→
🔗 MCP 协议
→
🎵 FL Studio MCP Server
→
🎹 虚拟 MIDI
→
🎶 FL Studio
📦
Node.js
运行 Claude CLI
🐍
Python 3.10+
运行 MCP 服务器
⚡
uv
Python 包管理
🎹
loopMIDI
虚拟 MIDI 端口
💻 第一阶段：环境准备
1

安装必要基础软件

确保电脑已安装以下软件：

软件用途安装方式
Node.js (LTS)运行 Claude CLI官网下载 https://nodejs.org，勾选 Add to PATH
Python 3.10+运行 MCP 服务器官网下载，勾选 Add Python to PATH
uvPython 包管理pip install uv
Git克隆项目仓库官网下载 https://git-scm.com
loopMIDI虚拟 MIDI 线缆从 tobias-erichsen.de 下载
检查命令node -v # 检查 Node.js python --version # 检查 Python（需要 3.10+） git --version # 检查 Git
安装时务必勾选 “Add to PATH”，否则终端无法直接调用。
2

安装 Claude CLI（Anthropic 官方命令行工具）

打开 CMD 或 PowerShell，执行：

终端npm install -g @anthropic-ai/claude-code

安装完成后验证：

验证claude --version
首次运行 claude 会引导登录 Anthropic 账号（需要 API Key 或订阅）。请提前准备好。
🎹 第二阶段：配置 FL Studio 环境
3

克隆 MCP 服务器项目

在你想存放项目的位置执行：

终端git clone https://github.com/karl-andres/fl-studio-mcp.git cd C:\fl-studio-mcp
网络慢可以直接从 GitHub 下载 ZIP 压缩包解压。
4

安装 Python 依赖

在项目目录下执行：

终端uv sync

这会自动创建虚拟环境并安装所有依赖。

5

配置 loopMIDI（虚拟 MIDI 端口）

AI 要与 FL Studio 交互需要虚拟 MIDI 端口。

操作步骤1. 运行 loopMIDI（从开始菜单找到） 2. 点击左下角 "+" 按钮 3. 创建新端口（名字可以任意，如 FL_AI） 4. 保持 loopMIDI 窗口打开（可以最小化，但不要关闭）
记住端口名称，后面配置 FL Studio 时会用到。
6

配置 FL Studio 的 MIDI 输入

让 FL Studio 识别虚拟 MIDI 端口。

FL Studio 操作1. 打开 FL Studio 2. 顶部菜单：Options → MIDI Settings（或按 F10 再切到 MIDI 页） 3. 在 Input 列表中找到你刚在 loopMIDI 创建的端口（如 FL_AI） 4. 点击它，在下方 Controller type 下拉菜单中选择 FLStudioMCP 5. 点击 Enable，确认端口左侧指示灯亮起
如果找不到 FLStudioMCP 控制器类型，请先完成下一步安装控制器脚本，然后重启 FL Studio 再回来检查。
7

安装 FL Studio 控制器脚本

如果上一步找不到 FLStudioMCP，在项目目录下执行：

终端# 创建 Hardware 文件夹（如果不存在） mkdir "%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Hardware\FLStudioMCP" 2>nul # 复制控制器脚本 copy fl_controller\device_FLStudioMCP.py "%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Hardware\FLStudioMCP\" # 创建 Piano roll scripts 文件夹（如果不存在） mkdir "%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Piano roll scripts" 2>nul # 复制钢琴卷帘脚本（可选，用于双向作曲） copy scripts\ComposeWithLLM.pyscript "%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Piano roll scripts\"
完成后重启 FL Studio，再回到 MIDI 设置，应该能看到 FLStudioMCP 选项了！
🔗 第三阶段：配置 Claude MCP 服务器（全局生效）
8

添加 FL Studio MCP 服务器到 Claude

在任意目录下打开终端，执行：

终端claude mcp add fl-studio --scope user -- uv run --directory C:/fl-studio-mcp fl-studio-mcp

解释：

  • --scope user：全局配置，任何项目下都能用
  • --：分隔 Claude 命令与要执行的命令
  • uv run --directory ... fl-studio-mcp：启动 MCP 服务器
成功后会提示：Added stdio MCP server fl-studio with command: uv run ... to user config
9

验证 MCP 服务器是否加载

运行以下命令检查：

终端claude mcp list

应该能看到 fl-studio 一行，Scope 为 user。

如果状态是 ✓ connected 则完美；如果是 failed，请运行 claude mcp logs fl-studio 查看错误。
10

启动 Claude 并测试

保持 loopMIDI 和 FL Studio 打开，然后：

终端# 在任意终端启动 Claude Code claude # 输入 /mcp 确认 fl-studio 状态为绿色

尝试下达指令，例如：

测试指令在 FL Studio 中写一段 C 大调的琵音，4 个小节，速度 120 BPM，使用钢琴音色。
Claude 会通过 MCP 控制 FL Studio 执行你的指令！

🎉 完成！你的工作流已就绪

✅ loopMIDI 运行中
+
✅ FL Studio 已连接
+
✅ Claude MCP 就绪

现在你可以用自然语言让 AI 帮你在 FL Studio 中创作音乐了！

📋 完整速查表（新电脑装机顺序）

步骤操作命令 / 要点
1安装 Node.js官网下载，勾选 Add to PATH
2安装 Python 3.10+勾选 Add to PATH
3安装 uvpip install uv
4安装 Git官网下载
5安装 loopMIDI官网下载，安装后创建虚拟端口
6安装 Claude CLInpm install -g @anthropic-ai/claude-code
7克隆 MCP 项目git clone https://github.com/karl-andres/fl-studio-mcp.git
8安装依赖cd fl-studio-mcp && uv sync
9安装 FL Studio 脚本第 7 步的 copy 命令
10配置 FL Studio MIDIMIDI 设置中选择 loopMIDI 端口，Controller type = FLStudioMCP
11添加 Claude MCPclaude mcp add fl-studio --scope user -- uv run --directory D:/fl-studio-mcp fl-studio-mcp
12验证claude mcp list
13开始使用claude 然后输入作曲指令

❓ 常见问题

Git clone 很慢或失败？

从 GitHub 下载 ZIP 压缩包手动解压到目标目录。

FL Studio 中看不到 FLStudioMCP 控制器？

确认已在项目目录下正确执行了第 7 步的 copy 命令，且 loopMIDI 端口已创建。重新打开 FL Studio 再检查 F10 设置。

Claude MCP 启动报错？

运行 claude mcp logs fl-studio 查看错误日志。大多数情况是路径错误或缺少 C++ Build Tools。

MCP 路径如何修改？

--directory 参数需改成你自己克隆 FL Studio MCP 项目的完整文件夹路径。例如：D:/fl-studio-mcp

基于视频教程整理的指令归纳总结 · FL Studio MCP 连接指南

总访问： 次