ACE Studio MCP 服务端

通过其实验性的 MCP 服务器将 ACE Studio 连接到 AI 客户端。

试验性状态

ACE Studio MCP Server 当前处于 试验阶段.

请注意：

• 某些功能和设置可能尚未完全实现

• 功能和特性可能会发生变更

• 使用过程中可能会遇到错误或性能问题

• 使用指南和速率限制将在稳定版本发布时公布

我们正在积极改进此功能。如有反馈或遇到问题，请通过以下方式与我们联系： [email protected].

ACE Studio MCP server 提供了丰富的工具集，使 AI 代理能够自主导航并执行创意编辑。通过让 AI 代理全面了解项目的每个细节，它能更高效且富有创造性地协助您创作和编辑歌曲。

模型上下文协议 (MCP) 是一个开放标准，允许 AI 助手与外部应用和数据源无缝连接。ACE Studio MCP server 实现了该协议，以便让 AI 代理直接访问您的创作工作区。

快速开始

启动 ACE Studio MCP Server

1. 打开 ACE Studio 2.0

2. 在偏好设置中，勾选 General → MCP Server

服务器地址： http://localhost:21572/mcp

技术说明：ACE Studio MCP Server 使用 Streamable HTTP 传输协议。请保留此地址以用于下一步配置。

将 MCP Server 连接到您的 AI 客户端

根据您的 AI 客户端选择合适的配置方式：

Claude Desktop

⚠ 在 Claude Desktop 中设置 ACE Studio MCP Server 需要编辑 JSON 配置文件。如果您不熟悉技术配置，建议尝试更适合普通用户的客户端。

配置步骤：

1. 安装 Node.js（如果尚未安装）

   • 访问 nodejs.org 并下载 LTS 版本

2. 定位 Claude Desktop 的配置文件

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 编辑配置文件并添加以下内容：

{
    "mcpServers": {
        "acestudio": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "http://localhost:21572/mcp"
            ]
        }
    }
}

1. 保存文件并重启 Claude Desktop

验证连接： 在 Claude 中输入：

请检查当前 ACE Studio 项目信息

如果 Claude 返回了项目详情，则连接成功！

---

Cursor

您可以通过点击直接将 MCP server 添加到 Cursor 此处.

或手动设置：

1. 打开 Cursor 设置

2. 找到 "Tools & MCP" 部分

3. 点击 "New MCP Server"

4. 填写以下 JSON：

   {
     "mcpServers": {
       "ACE-Studio": {
         "url": "http://localhost:21572/mcp",
         "headers": {}
       }
     }
   }

5. 点击 "保存"

6. 重启 Cursor

验证连接： 在 Cursor 聊天中输入：

@acestudio 当前项目中有哪些轨道？

---

VS Code（通过原生 MCP 支持）

您可以通过点击直接将 MCP server 添加到 VS Code 此处.

或手动设置：

1. 安装 Cline 或 Roo Cline 扩展

2. 打开扩展设置

3. 找到 MCP Servers 配置部分

4. 添加新服务器：

   "mcp": {
       "servers": {
           "ACE-Studio": {
               "type": "http",
               "url": "http://localhost:21572/mcp",
               "headers": {}
           }
       }
   }

---

VS Code（通过 Cline / Roo Code）

1. 安装 Cline 或 Roo Code 扩展

2. 打开扩展设置

3. 找到 MCP Servers 配置部分

4. 添加新服务器：

Cline

{
  "mcpServers": {
    "ACE-Studio": {
      "url": "http://localhost:21572/mcp",
      "type": "streamableHttp",
      "headers": {}
    }
  }
}

Roo Code

---

其他客户端 / AI 聊天机器人

对于大多数客户端, 使用以下配置设置：

• 传输类型： Streamable HTTP（某些客户端可能称其为 "Remote"）

• 服务器 URL： http://localhost:21572/mcp

或通过以下 JSON 导入 MCP server：

{
  "mcpServers": {
    "ACE-Studio": {
      "url": "http://localhost:21572/mcp",
      "headers": {}
    }
  }
}

注意：ACE Studio 需要 streamable HTTP 传输，不支持旧的 HTTP + SSE 协议或 MCP 版本 2024-11-05。

使用示例

连接成功后，您可以尝试以下提示与 AI 助手协作：

创建新工程

帮我在 ACE Studio 中创建一个 BPM 120 的流行风格新工程， 
调性为 C 大调，添加一条主唱轨道和一条小提琴伴奏轨道

生成歌词与旋律

基于主题 “海边的夏日回忆”， 
在 ACE Studio 中写一段 8 小节的副歌部分。 
旋律应轻快活泼，使用五声音阶

编辑 MIDI

在 ACE Studio 中，在第 9-16 小节添加一段钢琴和弦进行：
C - Am - F - G，每个和弦持续 2 小节