ACE Studio MCP 服务器

实验性状态

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

请注意：

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

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

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

• 关于使用规范和速率限制将在稳定版本发布时公布

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

ACE Studio MCP 服务器提供丰富的工具包，使 AI 代理能够自主浏览并执行创意编辑。通过向 AI 代理提供对项目每个细节的全面洞察，它可以更快、更有创造性地协助您创作和编辑歌曲。

Model Context Protocol （MCP）是一项开放标准，允许 AI 助手无缝连接外部应用和数据源。ACE Studio MCP 服务器实现了该协议，赋予 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 中输入：

Please check the current ACE Studio project information

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

---

Cursor

您可以通过点击直接将 MCP 服务器添加到 Cursor here.

或手动设置：

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 What tracks are in the current project?

---

VS Code (via Native MCP support)

您可以通过点击直接将 MCP 服务器添加到 VS Code here.

或手动设置：

1. 安装 Cline 或 Roo Cline 扩展

2. 打开扩展设置

3. 找到 MCP Servers 配置部分

4. 添加新服务器：

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

---

VS Code (via 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 服务器：

{
  "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 小节