数字音频工作站控制协议

Ardour MCP🎵

Ardour DAW的模型上下文协议服务器-通过AI助手控制Ardour

主要开源数字音频工作站的第一个MCP集成。Ardour MCP支持自然语言控制 热情 通过像克劳德这样的人工智能助手，使用 模型上下文协议.

🎯 这有什么作用

通过Claude Desktop或任何兼容MCP的客户端使用自然语言控制Ardour：

• “开始在曲目1和2上录制，然后设置从第5小节到第9小节的打孔录制”
• “为鼓创建4首音轨：踢腿、蜗牛、高帽、头顶”
• “将曲目1音量设置为-6dB，向左平移30%，并将曲目4静音”
• “以-12dB的音量将音轨发送到混响总线”
• “将增益自动化设置为轨道3上的写入模式”
• “检查混音中的相位问题和剪辑”
• “主输出的LUFS响度是多少？”

无需记忆命令，只需描述你想要什么！

🎹 MIDI生成集成

新：将Ardour MCP与 MIDI MCP服务器 完整的AI辅助音乐制作：

• “生成爵士钢琴伴奏曲目并将其导入Ardour”
• 以95 BPM的速度创建4小节鼓模式、低音线和和弦进行
• 用弦乐和铜管乐器编排管弦乐，然后混合

看 MIDI MCP服务器集成指南 用于设置和 完整的工作流程指南 例如。

✨ 当前状态

最新版本: v0.3.0 （2025年1月）

🎉 第3阶段完成-专业混音和大师

111个MCP工具 9个类别：

• 🚀 传输控制 （11个工具）：播放、停止、录制、导航
• 🎵 航迹管理 （5个工具）：创建、重命名、选择轨迹
• 📝 会话管理 （9个工具）：节奏、时间签名、会话信息
• 🎚️ 基本混合器 （14工具）：音量，平移，静音，独奏
• 🎛️ 高级混音器 （15个工具）：发送、插件、总线路由
• 📍 导航 （17个工具）：标记、循环、时间码
• 🎙️ 录制 （13个工具）：记录控制、输入/输出、监控
• 🤖 自动化 （13个工具）：自动化模式、录制、编辑
• 📊 计量 （12个工具）：电平、相位、响度、削波检测

质量指标:

• ✅ 581测试 通过与 86%的代码覆盖率
• ✅ 生产就绪，具有全面的错误处理功能
• ✅ 双向OSC通信，实时反馈
• ✅ 完整的文档和使用示例

功能时间线

看 ROADMAP.md 查看完整的功能时间线。

🚀 快速开始

在5分钟内完成设置！

先决条件

• Ardour 8.x或9.x 安装
• Python 3.10+ （支持Python 3.10、3.11、3.12）
• 克劳德桌面或克劳德代码 （或任何兼容MCP的客户端）

安装

# Install uv package manager
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and install
git clone https://github.com/raibid-labs/ardour-mcp.git
cd ardour-mcp
uv sync --all-extras

配置Ardour OSC

这是最重要的一步！

1. 启动Ardour并打开/创建会话
2. 首选 Edit → 偏好设置→ 控制曲面
3. 启用 “开放式声音控制（OSC）”
4. 点击 “显示协议设置”
5. 配置：
   • OSC服务器端口: 3819 （默认）
   • 反馈：启用 所有反馈选项
   • 点击 好的

配置MCP客户端

选择您的客户：

claude mcp add --transport stdio ardour --scope user \
  -- uv --directory /absolute/path/to/ardour-mcp run ardour-mcp

{
  "mcpServers": {
    "ardour": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/ardour-mcp",
        "run",
        "ardour-mcp"
      ]
    }
  }
}

claude mcp list
claude mcp get ardour

{
  "mcpServers": {
    "ardour": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/ardour-mcp",
        "run",
        "ardour-mcp"
      ]
    }
  }
}

详细的设置说明: docs/QUICK_START.md

📖 文档

🎯 入门指南

📚 功能指南

特定功能的完整使用指南：

🎹 集成指南

通过补充MCP服务器扩展Ardour MCP：

🏗️ 技术文档

架构、开发和参考资料：

🚀 项目管理

发布、路线图和发布：

🤝 贡献

🎬 示例工作流

录制会话设置

You: "I want to record a band. Set up 4 audio tracks called 'Kick', 'Snare',
     'Guitar', and 'Vocals'. Arm the kick and snare for recording and enable
     input monitoring on all of them."

Claude: ✓ Created audio tracks
        ✓ Armed tracks for recording
        ✓ Enabled input monitoring
        Your session is ready to record!

You: "Start recording!"

Claude: ✓ Recording started with 2 armed tracks

专业混音

You: "Set up parallel compression: create a bus called 'Parallel Comp',
     send all drum tracks to it at -10dB, and keep the original tracks active"

Claude: ✓ Created bus 'Parallel Comp'
        ✓ Routed drum tracks with sends at -10dB
        ✓ Original tracks remain active
        Your parallel compression chain is ready!

You: "Check my mix for phase issues and clipping"

Claude: Master: -8.2dB peak, -14.5 LUFS, no clipping ✓
        Phase correlation: +0.85 (good stereo image) ✓
        ⚠ Track 1 (Drums): Phase correlation -0.15 (check phase)

自动化录音

You: "Set track 3 to touch mode for gain automation, go to bar 8,
     and start playback so I can ride the fader"

Claude: ✓ Track 3: Gain automation set to TOUCH mode
        ✓ Positioned at bar 8
        ✓ Playback started
        Move the fader - automation is recording!

更多示例: docs/示例_对话.md

🏗️ 建筑

Ardour MCP使用三层架构进行双向通信：

┌─────────────────┐
│   AI Assistant  │  Claude Desktop, etc.
└────────┬────────┘
         │ MCP Protocol (stdio)
┌────────▼────────┐
│   MCP Server    │  ardour_mcp
│  ┌──────────┐   │
│  │  Tools   │   │  111 registered tools
│  └────┬─────┘   │
│  ┌────▼─────┐   │
│  │  State   │   │  Cached Ardour state with auto-updates
│  └────┬─────┘   │
│  ┌────▼─────┐   │
│  │OSC Bridge│   │  Bidirectional OSC communication
│  └────┬─────┘   │
└───────┼─────────┘
        │ OSC Protocol (UDP)
┌───────▼─────────┐
│     Ardour      │  Digital Audio Workstation
└─────────────────┘

主要特点:

• 双向OSC：发送命令并接收实时反馈
• 状态缓存：快速查询，无需OSC往返
• 自动更新：状态与Ardour更改同步
• 错误处理：全面的验证和错误消息

看 建筑.md 详细设计。

🧪 测试

581综合测试 随着 86%的代码覆盖率:

# Run full test suite
uv run pytest

# Run with coverage report
uv run pytest --cov=src/ardour_mcp --cov-report=term-missing

# Run specific test file
uv run pytest tests/test_automation.py

按模块划分的测试覆盖率:

• 自动化：98%
• 计量：96%
• 高级混音器：100%
• 国家管理：100%
• 集成测试：完成

看 封面_报告.md 进行详细分析。

🤝 贡献

我们欢迎开发人员、音乐家和音频工程师的贡献！

贡献方式:

• 🐛 通过以下方式报告错误和请求功能 GitHub问题
• 💻 提交pull请求（参见 贡献.md)
• 📖 改进文档
• 🎵 分享使用示例和工作流程
• ✨ 测试并提供反馈

好的第一个问题：查找标记的问题 good first issue

📦 出版

Ardour MCP可以发布到多个MCP注册表：

• PyPI：Python包（已配置）
• MCP社区注册：MCP服务器官方目录
• GitHub MCP注册表：与VS Code/Claude Desktop精心集成
• Docker MCP注册表：集装箱化部署

发布是自动化的 通过发布标签上的GitHub操作。

看 注册_博利欣.md 完整的自动化计划。

📋 发布

快速释放:

# Check what would be released
just release-status

# Create and push patch release
just release-auto-patch

# Create and push minor release
just release-auto-minor

发布工作流:

1. 手册 -完全控制 just release-patch
2. 半自动 -一个命令 just release-auto-patch
3. 全自动 -基于PR，请发布

版本方案: 语义版本控制2.0.0 （主要。次要。补丁）

看 发布.md 获取完整的发布文档。

🎓 资源

Ardour资源

• Ardour官方网站
• Ardour手册
• Ardour OSC文档
• Ardour论坛

MCP资源

• MCP规范
• MCP Python SDK
• MCP社区注册
• 克劳德桌面

项目链接

• GitHub存储库
• 问题追踪
• 讨论
• 发布

🎯 路线图

✅ 已完成的阶段

第一阶段（MVP） -2024年11月

• 核心传输、会话、轨道和混音器功能
• 27个MCP工具，98个测试

第2阶段（基本特征） -2024年11月

• 录音控制、导航、增强型混音器
• 总共86个工具，293个测试

第3阶段（高级混合） -2025年1月

• 先进的搅拌机，自动化，专业计量
• 总共111个工具，581个测试，86%的覆盖率

📋 计划阶段

第四阶段（生产） -2025年第一季度

• 插件参数自动化
• 区域编辑和操作
• 快照和模板管理
• 增强的会话管理

第5阶段（高级功能） -2025年第二季度

• MIDI音符编辑
• 时间签名和节奏自动化
• 高级路由（侧链、矩阵）
• 视频时间线同步

看 ROADMAP.md 查看详细的功能分解。

📊 项目统计

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 热情 -专业开源DAW
• Anthropic -模型上下文协议
• MCP社区 -协议规范和工具
• 管24 -MIDI MCP服务器集成
• 贡献者 -所有贡献代码、文档和反馈的人
• 测试人员 -社区成员提供宝贵反馈

📧 联系

• 问题: GitHub问题跟踪器
• 讨论: GitHub讨论
• 电子邮件: contact@raibid-labs.com
• 维护者：Raibid实验室

内置于❤️ 面向开源音频和人工智能社区

第一台用于专业音频制作的MCP服务器•连接创造力和人工智能辅助