# ACE Studio MCP 服务器

{% hint style="warning" %}

### 试验性状态

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

**请注意：**

* 某些功能和设置可能尚未完全实现
* 功能和特性可能会发生变更
* 使用过程中可能会遇到错误或性能问题
* 使用指南和速率限制将在稳定版本发布时公布

我们正在积极改进此功能。如有反馈或遇到问题，请通过以下方式与我们联系： [**support@acestudio.ai**](mailto:support@acestudio.ai).
{% endhint %}

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

[模型上下文协议 ](https://modelcontextprotocol.io/docs/getting-started/intro)(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](https://nodejs.org) 并下载 LTS 版本
2. 定位 Claude Desktop 的配置文件
   * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
   * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
3. 编辑配置文件并添加以下内容：

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

4. 保存文件并重启 Claude Desktop

**验证连接：**\
在 Claude 中输入：

```
请检查当前 ACE Studio 项目信息
```

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

***

#### **Cursor**

您可以通过点击直接将 MCP server 添加到 Cursor [此处](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9).

或手动设置：

1. 打开 Cursor 设置
2. 找到 "Tools & MCP" 部分
3. 点击 "New MCP Server"
4. 填写以下 JSON：

   ```json
   {
     "mcpServers": {
       "ACE-Studio": {
         "url": "http://localhost:21572/mcp",
         "headers": {}
       }
     }
   }
   ```
5. 点击 "保存"
6. 重启 Cursor

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

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

***

#### **VS Code（通过原生 MCP 支持）**

您可以通过点击直接将 MCP server 添加到 VS Code [此处](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22acestudio%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22http%3A%2F%2Flocalhost%3A21572%2Fmcp%22%7D).

或手动设置：

1. 安装 Cline 或 Roo Cline 扩展
2. 打开扩展设置
3. 找到 MCP Servers 配置部分
4. 添加新服务器：

   ```json
   "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. 添加新服务器：

{% tabs %}
{% tab title="Cline" %}

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

{% endtab %}

{% tab title="Roo Code" %}

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

{% endtab %}
{% endtabs %}

***

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

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

* **传输类型：** Streamable HTTP（某些客户端可能称其为 "Remote"）
* **服务器 URL：** `http://localhost:21572/mcp`

或通过以下 JSON 导入 MCP server：

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

{% hint style="info" %}
注意：ACE Studio 需要 streamable HTTP 传输，不支持旧的 HTTP + SSE 协议或 MCP 版本 2024-11-05。
{% endhint %}

## 使用示例

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

#### 创建新工程

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

#### 生成歌词与旋律

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

#### 编辑 MIDI

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