内容
# Ardour MCP 🎵
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://modelcontextprotocol.io/)
[](https://github.com/raibid-labs/ardour-mcp/actions)
[](docs/COVERAGE_REPORT.md)
[](CODE_OF_CONDUCT.md)
[](SECURITY.md)
**Ardour MCP 服务器 - 通过 AI 助手控制 Ardour**
首个适用于主要开源数字音频工作站的 MCP 集成。Ardour MCP 使您能够通过 AI 助手（如 Claude）使用自然语言控制 [Ardour](https://ardour.org/)。
## 🎯 功能概述
通过 Claude Desktop 或任何 MCP 兼容的客户端使用自然语言控制 Ardour：
- **"启动 1 和 2 号轨道的录音，然后设置 5 到 9 小节的 punch 录音"**
- **"为鼓创建 4 个音频轨道：低音鼓、军鼓、嗵嗵鼓、 Overhead"**
- **"将 1 号轨道的音量设置为 -6dB，定位 30% 向左，并静音 4 号轨道"**
- **"将人声轨道发送到混响总线，音量为 -12dB"**
- **"将 3 号轨道的增益自动化设置为写入模式"**
- **"检查我的混音中的相位问题和剪切"**
- **"主输出的 LUFS 响度是多少？"**
无需记忆命令 - 只需描述您想要的！
## 🎹 MIDI 生成集成
**新增功能**：将 Ardour MCP 与 [MIDI MCP 服务器](https://github.com/tubone24/midi-mcp-server) 结合使用，实现完整的 AI 辅助音乐制作：
- **"生成爵士钢琴 backing track 并导入 Ardour"**
- **"创建 4 小节的鼓模式、低音线和和弦进行，速度为 95 BPM"**
- **"制作一个带有弦乐和铜管的管弦乐编曲，然后混音"**
参见 [MIDI MCP 服务器集成指南](docs/integrations/MIDI_MCP_SERVER.md) 进行设置，[完整工作流指南](docs/integrations/MIDI_ARDOUR_WORKFLOW.md) 了解示例。
## ✨ 当前状态
**最新版本**：[v0.3.0](https://github.com/raibid-labs/ardour-mcp/releases/tag/v0.3.0) （2025 年 1 月）
### 🎉 第三阶段完成 - 专业混音和母带
**111 个 MCP 工具**，涵盖 9 类别：
- 🚀 **传输控制** （11 个工具）：播放、停止、录制、导航
- 🎵 **轨道管理** （5 个工具）：创建、重命名、选择轨道
- 📝 **会话管理** （9 个工具）：速度、时间签名、会话信息
- 🎚️ **基本混音器** （14 个工具）：音量、定位、静音、独奏
- 🎛️ **高级混音器** （15 个工具）：发送、插件、总线路由
- 📍 **导航** （17 个工具）：标记、循环、时间码
- 🎙️ **录音** （13 个工具）：录音控制、 punch in/out、监听
- 🤖 **自动化** （13 个工具）：自动化模式、录制、编辑
- 📊 **计量** （12 个工具）：音量、相位、响度、剪切检测
**质量指标**：
- ✅ **581 个测试**通过，**86% 代码覆盖率**
- ✅ 已准备好生产，具有全面的错误处理
- ✅ 与实时反馈的双向 OSC 通信
- ✅ 完整的文档和用法示例
### 功能时间线
| 阶段 | 状态 | 新增工具 | 亮点 |
|-------|--------|-------------|------------|
| **第一阶段** | ✅ 完成 | 27 | 传输、轨道、会话、基本混音器 |
| **第二阶段** | ✅ 完成 | 59 | 录音控制、导航、增强混音器 |
| **第三阶段** | ✅ 完成 | 40 | 高级混音器、自动化、计量 |
| **第四阶段** | 📋 计划中 | 待定 | 插件编辑、区域操作、MIDI |
参见 [ROADMAP.md](docs/ROADMAP.md) 了解完整的功能时间线。
## 🚀 快速开始
**5 分钟内完成设置！**
### 先决条件
- **Ardour 8.x 或 9.x** 已安装
- **Python 3.10+** （支持 Python 3.10、3.11、3.12）
- **Claude Desktop 或 Claude Code** （或任何 MCP 兼容的客户端）
### 安装
```bash
# 安装 uv 包管理器
curl -LsSf https://astral.sh/uv/install.sh | sh
# 克隆并安装
git clone https://github.com/raibid-labs/ardour-mcp.git
cd ardour-mcp
uv sync --all-extras
```
### 配置 Ardour OSC
**这是最重要的一步！**
1. 启动 Ardour 并打开/创建会话
2. 进入 **编辑 → 首选项 → 控制表面**
3. 启用 **"开放声音控制（OSC）"**
4. 点击 **"显示协议设置"**
5. 配置：
- **OSC 服务器端口**：`3819` （默认）
- **反馈**：启用 **所有反馈选项**
- 点击 **确定**
### 配置 MCP 客户端
选择您的客户端：
<details>
<summary><b>Claude Code</b> （推荐 - 一条命令！）</summary>
**使用 CLI** （最简单）：
```bash
claude mcp add --transport stdio ardour --scope user \
-- uv --directory /absolute/path/to/ardour-mcp run ardour-mcp
```
**手动配置** - 添加到 `.mcp.json` 中：
```json
{
"mcpServers": {
"ardour": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/ardour-mcp",
"run",
"ardour-mcp"
]
}
}
}
```
**验证安装**：
```bash
claude mcp list
claude mcp get ardour
```
服务器应显示为 "✓ 已连接"。 就是这样 - ardour-mcp 现已在 Claude Code 中可用！
</details>
<details>
<summary><b>Claude Desktop</b></summary>
将以下内容添加到您的 `claude_desktop_config.json` 中：
**macOS**：`~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**：`%APPDATA%\Claude\claude_desktop_config.json`
**Linux**：`~/.config/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"ardour": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/ardour-mcp",
"run",
"ardour-mcp"
]
}
}
}
```
重启 Claude Desktop，服务器即可使用。
</details>
**详细设置说明**：[docs/QUICK_START.md](docs/QUICK_START.md)
## 📖 文档
### 🎯 入门指南
| 文档 | 描述 |
|----------|-------------|
| **[快速入门指南](docs/QUICK_START.md)** | 5 分钟设置指南，含故障排除 |
| **[示例对话](docs/EXAMPLE_CONVERSATIONS.md)** | 真实对话示例，展示工作流程 |
| **[用法示例](docs/USAGE_EXAMPLES.md)** | 按类别划分的综合功能参考 |
### 📚 功能指南
特定功能的完整使用指南：
| 指南 | 工具 | 描述 |
|-------|-------|-------------|
| **[录音指南](docs/guides/RECORDING_EXAMPLE_USAGE.md)** | 13 个工具 | 录音控制、 punch in/out、监听 |
| **[混音器指南](docs/guides/MIXER_EXAMPLE_USAGE.md)** | 14 个工具 | 音量、定位、静音、独奏、批量操作 |
| **[高级混音器](docs/guides/ADVANCED_MIXER_USAGE.md)** | 15 个工具 | 发送、插件、总线路由、效果链 |
| **[导航指南](docs/guides/NAVIGATION_EXAMPLE_USAGE.md)** | 17 个工具 | 标记、循环、速度、时间码 |
| **[自动化指南](docs/guides/AUTOMATION_USAGE.md)** | 13 个工具 | 自动化模式、录制、编辑 |
| **[计量指南](docs/guides/METERING_USAGE.md)** | 12 个工具 | 音量、相位分析、响度、剪切 |
### 🎹 集成指南
将 Ardour MCP 与补充的 MCP 服务器扩展：
| 指南 | 描述 |
|-------|-------------|
| **[MIDI MCP 服务器](docs/integrations/MIDI_MCP_SERVER.md)** | 从自然语言生成 MIDI 作品 |
| **[完整工作流](docs/integrations/MIDI_ARDOUR_WORKFLOW.md)** | 端到端的音乐制作，使用 MIDI + Ardour |
### 🏗️ 技术文档
架构、开发和参考资料：
| 文档 | 描述 |
|----------|-------------|
| **[架构概述](docs/ARCHITECTURE.md)** | 系统设计和组件交互 |
| **[开发指南](docs/DEVELOPMENT.md)** | 设置、测试和贡献工作流 |
| **[OSC API 参考](docs/OSC_API.md)** | 完整的 Ardour OSC 命令参考 |
| **[覆盖率报告](docs/COVERAGE_REPORT.md)** | 测试覆盖率分析（86%） |
### 🚀 项目管理
发布、路线图和发布：
| 文档 | 描述 |
|----------|-------------|
| **[路线图](docs/ROADMAP.md)** | 功能时间线和里程碑 |
| **[发布](docs/RELEASING.md)** | 版本管理和发布流程 |
| **[发布前检查清单](docs/PRE_RELEASE_CHECKLIST.md)** | 发布前综合检查清单 |
| **[发布工作流](docs/RELEASE-WORKFLOWS.md)** | 自动化选项比较 |
| **[PyPI 设置](docs/PYPI_SETUP.md)** | 配置 PyPI 受信任发布 |
| **[注册发布](docs/REGISTRY_PUBLISHING.md)** | 发布到 MCP 注册表 |
### 🤝 贡献
| 文档 | 描述 |
|----------|-------------|
| **[贡献指南](CONTRIBUTING.md)** | 如何贡献代码和文档 |
| **[变更日志](CHANGELOG.md)** | 版本历史和发布说明 |
## 🎬 示例工作流
### 录音会话设置
```
您： "我想录制一支乐队。设置 4 个音频轨道，分别名为 '低音鼓'、'军鼓'、'
'吉他' 和 '人声'。启用 '低音鼓' 和 '军鼓' 的录音，并为所有人启用输入监听。"
Claude： ✓ 已创建音频轨道
✓ 已为录音启用了轨道
✓ 已启用输入监听
您的会话已准备好录音！
您： "开始录音！"
Claude： ✓ 已开始录音，启用了 2 个轨道
```
### 专业混音
```
您： "设置并行压缩：创建一个名为 '并行压缩' 的总线，将所有鼓轨道发送到它，音量为 -10dB，并保持原始轨道活动"
Claude： ✓ 已创建总线 '并行压缩'
✓ 已路由鼓轨道，发送音量为 -10dB
✓ 原始轨道保持活动
您的并行压缩链已准备就绪！
您： "检查我的混音是否有相位问题和剪切"
Claude： 主：-8.2dB 峰值，-14.5 LUFS，无剪切 ✓
相位相关性：+0.85（良好的立体声图像）✓
⚠ 轨道 1（鼓）：相位相关性 -0.15（检查相位）
```
### 自动化录制
```
您： "将 3 号轨道设置为增益自动化的触摸模式，前往第 8 小节，
并开始播放，以便我可以骑乘滑动条"
Claude： ✓ 3 号轨道：增益自动化设置为触摸模式
✓ 定位到第 8 小节
✓ 已开始播放
滑动条正在录制自动化！
```
**更多示例**：[docs/EXAMPLE_CONVERSATIONS.md](docs/EXAMPLE_CONVERSATIONS.md)
## 🏗️ 架构
Ardour MCP 使用三层架构进行双向通信：
```
┌─────────────────┐
│ AI 助手 │ Claude Desktop 等
└────────┬────────┘
│ MCP 协议（stdio）
┌────────▼────────┐
│ MCP 服务器 │ ardour_mcp
│ ┌──────────┐ │
│ │ 工具 │ │ 111 个注册工具
│ └────┬─────┘ │
│ ┌────▼─────┐ │
│ │ 状态 │ │ 缓存的 Ardour 状态，自动更新
│ └────┬─────┘ │
│ ┌────▼─────┐ │
│ │ OSC 桥接│ │ 双向 OSC 通信
│ └────┬─────┘ │
└───────┼─────────┘
│ OSC 协议（UDP）
┌───────▼─────────┐
│ Ardour │ 数字音频工作站
└─────────────────┘
```
**关键功能**：
- **双向 OSC**：发送命令并接收实时反馈
- **状态缓存**：快速查询，无需 OSC 往返
- **自动更新**：状态与 Ardour 更改同步
- **错误处理**：综合验证和错误消息
参见 [ARCHITECTURE.md](docs/ARCHITECTURE.md) 了解详细设计。
## 🧪 测试
**581 个综合测试**，**86% 代码覆盖率**：
```bash
# 运行完整测试套件
uv run pytest
# 运行覆盖率报告
uv run pytest --cov=src/ardour_mcp --cov-report=term-missing
# 运行特定测试文件
uv run pytest tests/test_automation.py
```
**按模块划分的测试覆盖率**：
- 自动化：98%
- 计量：96%
- 高级混音器：100%
- 状态管理：100%
- 集成测试：完整
参见 [COVERAGE_REPORT.md](docs/COVERAGE_REPORT.md) 了解详细分析。
## 🤝 贡献
我们欢迎开发者、音乐家和音频工程师的贡献！
**贡献方式**：
- 🐛 通过 [GitHub 问题](https://github.com/raibid-labs/ardour-mcp/issues) 报告错误并请求功能
- 💻 提交拉取请求（参见 [CONTRIBUTING.md](CONTRIBUTING.md)）
- 📖 改进文档
- 🎵 分享使用示例和工作流
- ✨ 测试并提供反馈
**新手问题**：查找标有 [`good first issue`](httpsgithub.com/raibid-labs/ardour-mcp/labels/good%20first%20issue) 的问题
## 📦 发布
Ardour MCP 可以发布到多个 MCP 注册表：
- **PyPI**：Python 包（已配置）
- **MCP 社区注册表**：官方 MCP 服务器目录
- **GitHub MCP 注册表**：与 VS Code/Claude Desktop 集成
- **Docker MCP 注册表**：容器化部署
**发布自动化**：通过 GitHub Actions 发布标签
参见 [REGISTRY_PUBLISHING.md](docs/REGISTRY_PUBLISHING.md) 了解完整的自动化计划。
## 📋 版本
**快速发布**：
```bash
# 检查将发布的内容
just release-status
# 创建并推送补丁发布
just release-auto-patch
# 创建并推送小版本
just release-auto-minor
```
**发布工作流**：
1. **手动** - 使用 `just release-patch` 完全控制
2. **半自动化** - 一条命令 `just release-auto-patch`
3. **全自动化** - 基于 PR 的 Release Please
**版本方案**： [Semantic Versioning 2.0.0](https://semver.org/) (MAJOR.MINOR.PATCH)
参见 [RELEASING.md](docs/RELEASING.md) 了解完整的发布文档。
## 🎓 资源
### Ardour 资源
- [Ardour 官方网站](https://ardour.org/)
- [Ardour 手册](https://manual.ardour.org/)
- [Ardour OSC 文档](https://manual.ardour.org/using-control-surfaces/controlling-ardour-with-osc/)
- [Ardour 论坛](https://discourse.ardour.org/)
### MCP 资源
- [MCP 规范](https://modelcontextprotocol.io/)
- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)
- [MCP 社区注册表](https://registry.modelcontextprotocol.io/)
- [Claude Desktop](https://claude.ai/desktop)
### 项目链接
- [GitHub 仓库](https://github.com/raibid-labs/ardour-mcp)
- [问题跟踪器](https://github.com/raibid-labs/ardour-mcp/issues)
- [讨论](https://github.com/raibid-labs/ardour-mcp/discussions)
- [版本](https://github.com/raibid-labs/ardour-mcp/releases)
## 🎯 路线图
### ✅ 已完成的阶段
**第一阶段（MVP）** - 2024 年 11 月
- 核心传输、会话、轨道和混音器功能
- 27 个 MCP 工具，98 个测试
**第二阶段（基本功能）** - 2024 年 11 月
- 录音控制、导航、增强混音器
- 总共 86 个工具，293 个测试
**第三阶段（高级混音）** - 2025 年 1 月
- 高级混音器、自动化、专业计量
- 总共 111 个工具，581 个测试，86% 覆盖率
### 📋 计划中的阶段
**第四阶段（生产）** - 2025 年第一季度
- 插件参数自动化
- 区域编辑和操作
- 快照和模板管理
- 增强的会话管理
**第五阶段（高级功能）** - 2025 年第二季度
- MIDI 音符编辑
- 时间签名和速度自动化
- 高级路由（侧链、矩阵）
- 视频时间线同步
参见 [ROADMAP.md](docs/ROADMAP.md) 了解详细的功能分解。
## 📊 项目统计
| 指标 | 值 |
|--------|-------|
| **总 MCP 工具** | 111 |
| **工具方法** | 111 个，涵盖 9 类别 |
| **测试套件** | 581 个测试通过 |
| **代码覆盖率** | 86% |
| **Python 版本** | 3.11+（支持 3.10） |
| **Ardour 版本** | 8.x，9.x |
| **最新版本** | v0.3.0 |
| **许可证** | MIT |
## 📄 许可证
该项目使用 MIT 许可证 - 参见 [LICENSE](LICENSE) 文件了解详情。
## 🙏 致谢
- **[Ardour](https://ardour.org/)** - 专业开源 DAW
- **[Anthropic](https://www.anthropic.com/)** - 模型上下文协议
- **MCP 社区** - 协议规范和工具
- **[tubone24](https://github.com/tubone24)** - MIDI MCP 服务器集成
- **贡献者** - 所有贡献代码、文档和反馈的人员
- **测试人员** - 社区成员提供宝贵的反馈
- **邮箱**：contact@raibid-labs.com
- **维护者**：Raibid Labs
---
**使用 ❤️ 为开源音频和 AI 社区构建**
*第一个适用于专业音频制作的 MCP 服务器 • 连接创意和 AI 助手*
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器