git clone https://github.com/KovacBro/dsh-fl-mcp.git
cd dsh-fl-mcp

python -m venv .venv
.venv\Scripts\python -m pip install -r requirements.txt
.venv\Scripts\python install.py --dsh "E:\你的DSH工作区"

set FL_STUDIO_DIR=D:\fls

servers:
  flstudio:
    transport: stdio
    command: "E:/path/to/dsh-fl-mcp/.venv/Scripts/python.exe"
    args:
      - "E:/path/to/dsh-fl-mcp/mcp/flstudio_mcp_server.py"
    env:
      FL_STUDIO_DIR: "D:/fls"
      PYTHONIOENCODING: "utf-8"
    toolCallTimeoutMs: 180000      # 写一次声部要开关窗口，给足 3 分钟

{
  "mcpServers": {
    "flstudio": {
      "command": "E:\\path\\to\\dsh-fl-mcp\\.venv\\Scripts\\python.exe",
      "args": ["E:\\path\\to\\dsh-fl-mcp\\mcp\\flstudio_mcp_server.py"],
      "env": { "FL_STUDIO_DIR": "D:\\fls", "PYTHONIOENCODING": "utf-8" }
    }
  }
}

fl_setup → fl_compose → fl_write_voice(piano) → fl_read_score
                          ↓
                     fl_write_voice(bass / drums / strings / …) → fl_read_score

.venv\Scripts\python tools\doctor.py --config "E:\你的DSH工作区\.dsh\mcp.servers.yml" --live

[1] initialize    -> flstudio-arranger v1.0.0  protocol=2024-11-05
[2] tools/list    -> 9 个工具：fl_status, fl_install_bridge, fl_compose, ...
[3] fl_status     -> FL 找到=True 版本=26.1.7 运行中=False 目录=D:/fls
[4] fl_setup      -> OK  5.3s
[5] fl_compose    -> OK  ...\arrange_pop_C_8bar.mid
[6] fl_write_voice-> OK  写入 137 音
[7] fl_read_score -> OK  读回 137 音  音域 [41, 84]
    闭环核对：写 137 / 读 137 -> 一致 ✓

dsh-fl-mcp/
├─ install.py                  一键安装（探测 FL + 注册客户端 + 自检）
├─ mcp/
│  ├─ flstudio_mcp_server.py   MCP 服务器（stdio，零第三方依赖）
│  ├─ fl_core.py               FL 探测 / 窗口 / 队列
│  ├─ fl_gui.py                截屏、点击、对话框、导入导出
│  ├─ fl_voices.py             六声部写作器 + 平行五八度检查 + fl_safe
│  ├─ harmony_engine.py        斯波索宾和声引擎
│  ├─ midi_writer.py           多轨 MIDI 写出
│  └─ midi_reader.py           MIDI 解析（回读用）
├─ fl_scripts/
│  └─ MCP_Bridge.pyscript      FL 钢琴卷帘桥接脚本（可选）
├─ tools/
│  ├─ doctor.py                跨客户端健康检查（--live 真写 FL）
│  ├─ selftest.py              桥接链路自检（假 FL，不依赖 GUI）
│  ├─ mcp_smoke.py             MCP 协议冒烟测试
│  └─ probe.py / shot.py       调试用：截图、发按键
├─ references/
│  ├─ 01-instrument-voicing.md 六声部乐器法与平行五八度判定口径
│  ├─ 02-workflow.md           FL 里从音符到成品
│  └─ 03-github-survey.md      GitHub 现成 FL MCP 的调研与选型
├─ agents/
│  └─ fl-studio-arranger.md    可选：包成专家团的 agent 定义
├─ demo/                       示例 MIDI 与真机截图
└─ SKILL.md                    另一个形态：给支持 Skill 的客户端当技能包用