midi ctrl

MCP音视频

提供方 nanassound

音视频 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

MIDICtrl是一款基于HTTP的MCP协议服务器,通过自然语言对话控制Arturia MicroFreak合成器的参数调整和音色切换。

一句话选型结论

按资料字段整理

midi ctrl 属于音视频类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类音视频 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 6 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

音视频
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Elixir本地部署音乐制作AI控制MIDI工具合成器控制自然语言交互

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
转写与字幕

把音视频转成文字和字幕。

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在音视频场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
midi ctrl当前 未标注 未标注 未标注 无 2026-05-17
Ableton MCP B7b69a6a 16 stdio · 本地进程 本地部署 有 2026-05-17
Mini Max MCP 8 SSE · 服务端推送 远程部署 有 2026-05-18
LocalAI 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Youtube E0eb3510 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Voicemode MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

音视频
字段来自项目仓库与公开索引,中文说明由本站标注
提供方nanassound上游标注的维护方 nanassound
分类音视频本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.3 KB
来自项目仓库与上游目录的原文,未做删改

MIDICtrl

用AI控制Arturia MicroFreak合成器

MIDICtrl是基于HTTP的 模型上下文协议(MCP) 将MCP兼容LLM与Arturia MicroFreak合成器桥接的服务器。通过自然语言对话调整参数、切换振荡器类型或探索声音。适用于支持MCP协议的任何LLM客户端。```
You: "Make the filter brighter and increase resonance"
AI: adjusts Filter Cutoff (CC 23) and Resonance (CC 83) on your MicroFreak


## YouTube上的演示

## 这是什么?

### MIDI(乐器数字接口)

MIDI是一种让电子乐器、计算机和音频设备通信的协议。MIDI不发送音频,而是发送“播放音符C4”或“将过滤器截止设置为80”等消息

**关键MIDI概念:**

- **MIDI接口**:用于发送/接收MIDI消息的连接点(如USB或硬件连接)
- **MIDI通道**:16个单独的通道(0-15),用于将消息路由到不同的仪器
- **CC(控制权变更)**:调整音量、滤镜或效果等参数的消息(0-127范围)
- **端口方向**:
- *输入端口* 接收MIDI(例如,从键盘到计算机)
- *输出端口* 发送MIDI(例如,从您的计算机发送到合成器)

### MCP(模型上下文协议)

MCP是Anthropic的开放协议,允许AI助手与外部工具和数据源安全交互。MIDICtrl将MIDI功能作为MCP工具公开,任何兼容的LLM都可以在对话中调用。

**工作原理:**```
You chat with an MCP-compatible AI client (e.g., Claude Desktop)
↓
The AI uses MIDICtrl tools (list ports, send CC messages, etc.)
↓
MIDICtrl translates requests to MIDI
↓
Your Arturia MicroFreak responds

特性

  • MIDI端口发现:列出所有连接的MIDI设备
  • MicroFreak控制变化:调整MicroFreak上的任何CC参数
  • 批量操作:在一个命令中发送多个参数更改
  • 命名振荡器类型:使用友好名称在22种振荡器类型之间切换
  • LLM友好:自然语言界面——基本使用不需要MIDI知识
  • 文档即资源:AI可以访问完整的MicroFreak MIDI参考

快速开始

先决条件

对于macOS用户(预构建版本):

  • macOS计算机
  • Arturia MicroFreak通过USB连接
  • MCP兼容的AI客户端(例如,Claude Desktop)

对于Linux/Windows/Mac用户或开发人员:

  • Elixir 1.19+和Erlang/OTP
  • Arturia MicroFreak通过USB连接
  • MCP兼容的AI客户端(例如,Claude Desktop)

安装

选项1:预构建版本(仅限macOS Apple Silicon)```bash

Download the macOS release

wget https://github.com/nanassound/midi_ctrl/releases/download/v0.1.0/midi_ctrl-macos-arm.tar.gz

Extract

tar -xzf midi_ctrl-macos-arm.tar.gz
cd midi_ctrl

Start the server (no Elixir/Erlang required!)

./bin/midi_ctrl start

Server runs on http://localhost:3000


#### 选项2:来源(Linux/Windows/Mac)```bash
# Clone the repository
git clone https://github.com/nanassound/midi_ctrl.git
cd midi_ctrl

# Install dependencies
mix deps.get

# Run the server
elixir run_mcp.exs

# Server starts on http://localhost:3000

构建自己的版本(可选):

如果你想为你的平台创建一个独立版本:```bash

Build release

MIX_ENV=prod mix release

The release will be in _build/prod/rel/midi_ctrl/

Start it with:

_build/prod/rel/midi_ctrl/bin/midi_ctrl start


**注:** 发布是特定于平台的。基于macOS的版本在Linux/Windows上无法运行。

### 配置您的MCP客户端

将MIDICtrl添加到MCP客户端配置中。以下是Claude Desktop的示例:

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**窗户:** `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"midi_ctrl": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
}
}
}

重新启动MCP客户端 保存配置后。

验证连接

  1. 启动MIDICtrl服务器(请参阅上面的安装)
  2. 打开您的MCP客户端(例如,Claude Desktop)
  3. 在LLM UI中查找工具名称
  4. 试试:“你看到了什么MIDI端口?”

AI应该使用以下命令列出您连接的MIDI设备 list_ports 工具。

使用示例

基本:列出您的MIDI设备```

You: "What MIDI devices are connected?"

AI: uses list_ports tool

I can see you have these MIDI devices:
- Arturia MicroFreak (output, port 2)
- USB MIDI Interface (input, port 0)


### 控制更改消息```
You: "Set the filter cutoff to 100 and resonance to 80 on my MicroFreak"

AI: *uses microfreak_cc tool with CC 23 (cutoff) and CC 83 (resonance)*

I've adjusted your MicroFreak:
- Filter Cutoff: 100
- Filter Resonance: 80

切换振荡器类型```

You: "Switch my MicroFreak to the Wavetable oscillator"

AI: uses microfreak_set_oscillator tool

Done! Your MicroFreak is now using the Wavetable oscillator.


### 创意音效设计```
You: "Create a warm pad sound on my MicroFreak"

AI: I'll set up a warm pad for you:
- Oscillator: SuperWave (for richness)
- Filter Cutoff: 60 (darker tone)
- Resonance: 30 (subtle emphasis)
- Attack: 40 (slow fade-in)
- Release: 70 (long tail)

*sends multiple CC changes*

Try playing now—you should have a lush, warm pad sound!

可用工具

1. list_ports

发现所有连接的MIDI设备。

论据: 无

退货: MIDI端口列表,包括:

  • name:设备名称(例如“Arturia MicroFreak”)
  • direction: input 或 output
  • num:端口号标识符

例子:```
name: Arturia MicroFreak
direction: output
num: 2


### 2. `microfreak_cc`

发送MIDI控制更改消息以调整Arturia MicroFreak参数。

**论据:**

- `port_pattern` (字符串,必填):与MIDI端口名称匹配的模式(例如“MicroFreak”)
- `cc_changes` (数组,必填):CC更改列表 `[{cc: number, value: number}]`
- `channel` (整数,可选):MIDI通道0-15(默认值:0)
- `delay_ms` (整数,可选):消息之间的延迟(毫秒)(默认值:0)

**常见的MicroFreak CC编号:**

- CC 23:滤镜截止(0-127,亮度)
- CC 83:滤波器谐振(0-127,强调)
- CC 12:音色(0-127,音调特征)
- CC 13:形状(0-127,波形形状)
- CC 105:信封攻击(0-127,淡入时间)
- CC 106:信封衰减(0-127,淡出时间)
- CC 29:包络维持(0-127,保持水平)
- CC 9:振荡器类型(0-127,见振荡器类型)

**完整CC参考:** 看 docs/microbreak_midi_reference.md

**例子:**```json
{
"port_pattern": "MicroFreak",
"cc_changes": [
{"cc": 23, "value": 100},
{"cc": 83, "value": 60}
],
"channel": 0
}

3. microfreak_set_oscillator

使用友好的名称在Arturia MicroFreak上的22种振荡器类型之间切换。

论据:

  • port_pattern (字符串,必填):与MIDI端口名称匹配的模式
  • oscillator_type (字符串,必填):振荡器名称(见下文)
  • channel (整数,可选):MIDI通道0-15(默认值:0)

可用振荡器类型(共22种):

名称 描述
BasicWaves 经典模拟波形(锯齿形、方形、三角形)
超波 厚的失谐锯齿波
波表 变形波表合成
Harmo 谐波加法合成
KarplusStr Karplus强弦合成
V.模拟 虚拟模拟建模
波形整形器 波形整形合成
TwoOpFM 双操作员FM合成
Formant 人声共振峰合成
和弦 和弦发生器
语音 语音合成
模态 模态谐振器合成
噪声 噪声发生器
低音 低音优化合成
SawX 增强锯齿
HarmNE 谐波噪声发动机
WaveUser 用户波长表
示例 示例回放
ScanGrains 扫描颗粒合成
CloudGrains 云颗粒合成
HitGrains 冲击式颗粒合成
声码器 声码器合成

例子:json { "port_pattern": "MicroFreak", "oscillator_type": "Wavetable", "channel": 0 }

示例提示

以下是一些通过人工智能助手与MicroFreak互动的创造性方法:

探索:

  • “你能在我的MicroFreak上控制什么?”
  • “显示我连接了哪些MIDI设备”
  • “有哪些振荡器类型可供选择?”

声音设计:

  • “营造明亮、咄咄逼人的领先声音”
  • “做一个低沉、隆隆的低音补丁”
  • “给我一个太空环境垫”
  • “随机化5个参数,给我一个惊喜”

学习:

  • “解释滤波器谐振的作用,然后通过从0到127的扫描来演示它”
  • “给我看看Wavetable和V.模拟振荡器之间的区别”
  • “通过调整不同的参数教我MIDI CC”

精确控制:

  • “将滤波器截止设置为80,共振设置为40,攻击设置为50”
  • “切换到模态振荡器并将音色设置为100”
  • “将值为64的CC 12发送到我的合成器”

高级主题

面向开发人员和贡献者

看 CLAUDE.md 用于:

  • 架构和代码结构
  • 添加新的MCP工具
  • 开发工作流程
  • 测试和格式化
  • 构建发布以供分发
  • CI/CD设置

MicroFreak MIDI参考

看 docs/microbreak_midi_reference.md 用于:

  • 完整的CC参数列表(30+个参数)
  • 振荡器特定参数
  • 声音设计示例
  • MIDI实现图

添加对其他合成器的支持

目前,MIDICtrl仅支持Arturia MicroFreak。要添加对其他合成器的支持:

  1. 在合成器手册中查找MIDI实现(CC编号和范围)
  2. 在中创建新的MCP工具 lib/midi_ctrl/router.ex
  3. 在中添加操作逻辑 lib/midi_ops.ex
  4. 文档中的CC映射 docs/your_synth_midi_reference.md

工具名称示例: moog_cc, roland_cc, korg_patch_select

欢迎为其他合成器添加支持的贡献!

故障排除

“未找到MIDI端口”

  • 确保您的MIDI设备已通电并连接
  • 检查系统的MIDI设置/驱动程序
  • 在macOS上:检查音频MIDI设置应用程序
  • 在Linux上:验证ALSA/JACK配置
  • 尝试拔下并重新连接设备

“端口模式与任何端口都不匹配”

  • 跑 list_ports 首先查看确切的设备名称
  • 使用部分匹配(例如,“Micro”而不是“Arturia MicroFreak”)
  • 检查端口模式中的拼写错误

“我的MCP客户端看不到MCP工具”

  • 验证MIDICtrl服务器是否正在运行(检查http://localhost:3000)
  • 确认您的MCP客户端配置已正确保存
  • 配置更改后重新启动MCP客户端
  • 检查 npx 可利用性: which npx 终端中

“服务器无法启动”

  • 检查端口3000是否已在使用中: lsof -i :3000
  • 尝试其他端口: PORT=8080 elixir run_mcp.exs
  • 更新配置以匹配: "http://localhost:8080/mcp"

贡献

欢迎投稿!请看 CLAUDE.md 用于开发设置和指南。

贡献领域:

  • 支持其他合成器(Moog、Korg、Roland、Novation等)
  • MicroFreak的更多MIDI功能(程序更改、sysex等)
  • 更好的错误处理和用户反馈
  • Linux和Windows的预构建版本
  • 文档改进

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

版权所有(c)2025 Nanas Sound

致谢

  • 内置于 灵药 和 匪徒
  • MIDI功能通过 Midiex
  • 实现 模型上下文协议(MCP) 通过Anthropic
  • 受到人工智能辅助音乐制作的创造性可能性的启发

链接

  • 文档: CLAUDE.md (开发者), docs/ (MIDI参考)
  • MCP规范: https://modelcontextprotocol.io
  • 克劳德桌面: https://claude.ai/download
  • 问题和反馈: GitHub问题

使用Claude Code在人工智能的帮助下制作 🎹🤖

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
midi ctrl 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

midi ctrl 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

midi ctrl 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

midi ctrl 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

midi ctrl 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

midi ctrl 能提供哪些能力?

资料显示能力标签包括 Claude、自然语言交互、语音音频。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。