内容
# 通用FLStudioMCP
**v26.0 Alpha 1**
UFM | 启用您的AI代理通过操作UFM命令行界面或MCP服务器来控制FL Studio，以安排和创作音乐。
## 当前范围
本实现为FL Studio资源和AI驱动的项目规划器提供安全的只读发现功能：
- 检测FL Studio安装、用户数据和可执行文件路径
- 列出捆绑的模板、演示/渲染测试项目、用户项目和插件
- 显式按路径请求打开现有的`.flp`项目
- 通过复制捆绑的用户`.flp`模板创建可写入的项目
- 将FLP文件扫描到数据集准备元数据中
- 将FLP数据集摘要导出为JSON
- 训练和评估基线项目规划器模型
- 生成具有标记感知检索的项目计划
- 使用附带元数据管理生成的项目
## 命令行界面
```bash
ufm info
ufm templates --limit 20
ufm demos --limit 20
ufm projects --limit 20
ufm plugins --limit 50
ufm create-from-template "C:\\path\\to\\template.flp" "My Generated Track"
ufm scan-dataset --limit 100
ufm export-dataset "C:\\path\\to\\flp_dataset.json" --limit 1000
ufm build-manifest ".\\data\\manifest.json" --limit 1000
ufm enrich-manifest ".\\data\\manifest.json" --output-path ".\\data\\manifest.enriched.json"
ufm parse-manifest ".\\data\\manifest.enriched.json" --output-path ".\\data\\manifest.parsed.json"
ufm export-instructions ".\\data\\manifest.parsed.json" ".\\data\\instructions.jsonl"
ufm train-baseline ".\\data\\instructions.jsonl" ".\\runs\\baseline"
ufm train-baseline ".\data\instructions.v3.jsonl" ".\runs\project-planner-v2" --max-vocab-size 5000
ufm predict-baseline ".\\runs\\project-planner-v2\\baseline_model.json" "Create a dark trap FL Studio project" --source demo
ufm eval-baseline ".\\runs\\project-planner-v2\\baseline_model.json" ".\\data\\instructions.v3.jsonl" --limit 25
ufm eval-expert ".\runs\project-planner-v2\baseline_model.json" ".\data\eval.project_planner.json"
ufm build-from-baseline ".\\runs\\baseline\\baseline_model.json" "Create a dark trap FL Studio project" --source demo --project-name "My Generated Track"
ufm build-from-baseline ".\\runs\\baseline\\baseline_model.json" "Create a dark trap FL Studio project" --source demo --project-name "My Generated Track" --no-metadata
ufm build-from-plan ".\\data\\project_plan.json" --project-name "My Generated Track"
ufm generated list --root ".\\generated"
ufm generated search "trap" --root ".\\generated" --source demo --min-confidence 0.8
ufm generated latest --root ".\\generated"
ufm generated stats --root ".\\generated"
ufm generated show ".\\generated\\My Generated Track.flp.ufm.json"
ufm generated rebuild ".\\generated\\My Generated Track.flp.ufm.json" --project-name "My Generated Track Rebuilt"
ufm generated open ".\\generated\\My Generated Track.flp.ufm.json"
ufm split-manifest ".\\data\\manifest.parsed.json" ".\\data\\splits"
ufm analyze-flp "C:\\path\\to\\project.flp"
ufm open "C:\\path\\to\\project.flp"
ufm serve
```
## MCP 配置
```json
{
"mcpServers": {
"universal-flstudio-mcp": {
"command": "ufm",
"args": ["serve"]
}
}
}
```
## 环境变量覆盖
- `FL_STUDIO_HOME`：FL Studio安装目录
- `IMAGE_LINE_USER_DIR`：Image-Line用户文档目录
