fcp 中午
用于语义MIDI合成的MCP服务器。
它的作用
fcp-midi允许LLM通过描述音乐意图(音符、和弦、动态、节奏变化)来创作音乐,并将其渲染为标准midi文件。LLM不处理原始字节或MIDI事件,而是使用以下操作 note Bass E2 at:1.1 dur:quarter vel:90 和 crescendo @track:Lead vel:45-75 @range:3.1-6.4.建立在 FCP 框架,由漂亮的midi提供序列化支持。
快速示例```
midi_session('new "Voltage Drop" tempo:140 key:E-minor')
midi([
'note Drums kick at:1.1 dur:eighth vel:100',
'note Bass E2 at:1.1 dur:quarter vel:90',
'chord Pad Em at:1.1 dur:whole vel:70',
'crescendo @track:Lead vel:45-75 @range:3.1-6.4',
'tempo 174 at:11.1',
])
midi_session('save as:./voltage_drop.mid')
### 可用的MCP工具
|工具|目的|
|------|---------|
| `midi(ops)` |批量突变——音符、和弦、曲目、节奏、动态、复制/转置|
| `midi_query(q)` |检查构图——地图、曲目、事件、钢琴曲、乐器,找到|
| `midi_session(action)` |生命周期——新建、打开、保存、检查点、撤消、重做|
| `midi_help()` |完整参考卡|
### 英雄示例
**水管工之旅** --忠实再现经典游戏主题:4首曲目,288个音符,16秒,180 BPM。
**电压降** --一首带有节奏加速(140->155->174BPM)的鼓和低音曲目,5首曲目,破拍,低音,琶音和一个标志性的DROP部分。FCP与原始Python代理之战中也使用了FCP——FCP在87秒内在12个轨道上生成了1674个音符,而手写Python约689行中生成了694个音符。
看 `docs/examples/` 用于MIDI文件和完整的写入。
## 安装
需要Python>=3.11。```bash
pip install fcp-midi
MCP客户端配置```json
{
"mcpServers": {
"midi": {
"command": "uv",
"args": ["run", "python", "-m", "fcp_midi"]
}
}
}
## 建筑
三层架构:```
MCP Server (Intent Layer)
Parses op strings, dispatches to verb handlers
|
Semantic Model
Tracks, notes, chords, dynamics, tempo maps, markers
In-memory composition graph with event sourcing
|
Serialization (pretty-midi)
Semantic model -> MIDI binary output
主要特点:
- 仪器库 --GM仪器名称(
acoustic-grand-piano,synth-bass-1,standard-kit) - Soundfont支持 --加载自定义仪器库
- 节拍寻址 --
at:1.1(第1杆,第1拍),at:3.2.240(第3杆,第2拍,第240拍) - 持续时间词汇 --
whole,half,quarter,eighth,sixteenth,triplet - 动力学 --
crescendo,diminuendo跨范围 - 复制/转置 --复制和转换音乐短语
发展```bash
uv sync
uv run pytest # 658 tests
uv run pytest -m "not slow" # skip stress tests
uv run ruff check # linting
uv run pyright # type checking
```
许可证
麻省理工学院
