ACE Studio MCP Server

试验性状态

ACE Studio MCP 服务器当前处于 试验阶段.

请注意：

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

• 功能和行为可能会发生变化

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

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

我们正在积极改进此功能。如果您有任何反馈或遇到问题，请通过以下方式与我们联系： 如果您在使用 ACE Bridge 2 时遇到任何问题，您可以点击 ACE Bridge 2 左下角的.

ACE Studio MCP 服务器提供丰富的工具集，使 AI 代理能够自主导航并执行创意编辑。通过向 AI 代理提供对工程中每个细节的全面了解，它可以更快速、更具创造性地协助您创作和编辑歌曲。

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

快速开始

启动 ACE Studio MCP 服务器

1. 打开 ACE Studio 2.0

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

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

技术说明：ACE Studio MCP 服务器使用 可流式 HTTP 传输协议。请保留此地址以用于下一步配置。

将 MCP 服务器连接到您的 AI 客户端

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

Claude Desktop

⚠ 在 Claude Desktop 中配置 ACE Studio MCP 服务器需要编辑 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 服务器添加到 Cursor 此处.

或手动设置：

1. 打开 Cursor 设置

2. 找到 “Tools & MCP” 部分

3. 点击 “New MCP Server”

4. 填写以下 JSON：

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

5. 点击 “Save”

6. 重启 Cursor

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

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

---

VS Code（通过原生 MCP 支持）

您可以通过点击直接将 MCP 服务器添加到 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 聊天机器人

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

• 传输类型： 可流式 HTTP（某些客户端可能称其为 “Remote”）

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

或通过以下 JSON 导入 MCP 服务器：

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

注意：ACE Studio 要求使用可流式 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 小节