内容
# 极光音频工作台（Aurora）MCP服务端 + 命令行工具 + 技能包
MCP服务端 + 命令行工具 + 技能包，适用于 **Aurora**，即极光音频工作台 — 通过Claude Code、Cursor、Claude Desktop或任何支持MCP的客户端，驱动音乐生成、风格转换封面、样本制造、7轨分离和DAW-ready轨组织。
本单仓发布两个可安装的包，以及它们共享的核心：
- **`@ericdisero/aurora-mcp-server`** — 标准输入输出MCP服务端。运行命令：`npx -y @ericdisero/aurora-mcp-server`。
- **`@ericdisero/aurora-cli`** — `aurora`二进制文件。运行命令：`npm i -g @ericdisero/aurora-cli`。
- **`@ericdisero/aurora-shared`** — 两个表面依赖的操作层。
## 功能描述
MCP/命令行工具为AI代理提供对Aurora音乐库的完全控制：创建项目、生成完整曲目（Suno）、将现有音频转换为新风格（带有`audioWeight`旋钮的封面）、制造关键/节拍锁定的样本和单拍、将任意音频拆分为7轨（人声、低音鼓、军鼓、中鼓、帽子、低音、其他，通过MVSEP +本地相位取消）。**31种工具**。磁盘上的文件是产品 — 所有文件都放入实际的项目文件夹中，Aurora桌面应用程序实时显示。
独立设计：服务端直接与Aurora的数据库和项目文件夹交互。桌面应用程序无需运行（掌握 — 分析/混合/导出 — 目前仍在应用程序窗口中）。
## 安装配置
1. 配置提供商密钥（一次性）：
```bash
npm i -g @ericdisero/aurora-cli
aurora keys --suno-api-key <密钥> --mvsep-api-key <密钥>
```
（或跳过命令行工具，通过MCP配置的`env`块传递密钥）
2. 添加到MCP配置：
```json
{
"mcpServers": {
"aurora": {
"command": "npx",
"args": ["-y", "@ericdisero/aurora-mcp-server"]
}
}
}
```
Claude Code一键式命令：`claude mcp add aurora -- npx -y @ericdisero/aurora-mcp-server`
## 使用方法
### 命令行工具（Claude Code，终端脚本）
```bash
aurora status # Aurora的数据存储位置 + 密钥状态
aurora install-skills # 捆绑代理配方 → ./.claude/skills/<名称>/SKILL.md
aurora mcp # 打印（或复制）MCP客户端配置
aurora run --list # 列出所有操作
aurora run aurora_create_project --name "午夜驾驶"
aurora run aurora_sounds --prompt "巨大的电影音效，黑暗的低音长号" --soundKey Cm --tempo 140
aurora run aurora_split --assetId <ID> --background
aurora run aurora_get_job_status --jobId spl-xxxx
```
### 长任务 + 流媒体预览
生成（1-3分钟）和拆分（3-5+分钟）支持`background: true` → 轮询`aurora_get_job_status`。在生成过程中，状态包括**流媒体URL — 可在30-45秒后收听，比文件落地时间早几分钟**。拆分后的音轨随着每个MVSEP任务的完成而逐步落地。任务在重启后存活（提供商侧状态存储在`userData/agent-jobs/`）。
## 架构
```
~/.aurora/config.json ← 提供商密钥（或环境变量；环境变量优先）
<userData>/aurora.db ← Aurora自己的SQLite库（WAL — 应用程序 + 代理共存）
<userData>/projects/<slug>/ ← 生成/封面/导入/引用/音轨/主音轨/
<userData>/agent-jobs/ ← 后台任务清单
@ericdisero/aurora-shared ← 操作/index.ts（单个工具接口）、存储、
Suno + MVSEP客户端、任务、拆分、ffmpeg
@ericdisero/aurora-mcp-server ← 标准输入输出服务端，注册操作为MCP工具
@ericdisero/aurora-cli ← 命令行入口：运行/安装技能/密钥/状态/MCP
```
## 发布
发布顺序很重要：共享 → 服务端 → 命令行工具（两者都依赖共享版本）。始终从仓库根目录运行：
```bash
npm run publish:all
```
## 许可证
MIT。版权所有 Blueprint Online Learning Inc.
