Перейти к основному содержанию

​
Обзор

Model Context Protocol (MCP) — это новый протокол, который позволяет AI-программным помощникам напрямую вызывать внешние инструменты и API. Ace Data Cloud предоставляет несколько MCP Server (Suno, Midjourney, SERP и др.), которые можно использовать непосредственно в таких инструментах, как Cursor, Claude Desktop и других.

​
Задействованные сервисы

  • Suno: POST https://api.acedata.cloud/suno/audios
  • Midjourney: POST https://api.acedata.cloud/midjourney/imagine
  • Google Search: POST https://api.acedata.cloud/serp/google

​
Техническое решение

​
Предварительные условия

  1. Зарегистрироваться на Ace Data Cloud
  2. Получить API Token
  3. Установить Python 3.7+ и библиотеку requests

​
Шаги реализации

​
Шаг 1: Установка MCP Server

Установите через pip: pip install mcp-suno (или mcp-midjourney, mcp-serp).

​
Шаг 2: Настройка Token

Установите переменную окружения ACEDATACLOUD_API_TOKEN со значением вашего API Token.

​
Шаг 3: Использование в программных инструментах

Добавьте соответствующий Server в настройках MCP в Cursor или Claude Desktop.

​
Пример кода

Ниже приведён полный пример на Python с использованием Suno: 
import requests

API_TOKEN = "YOUR_API_TOKEN"

def call_suno():
    response = requests.post(
        "https://api.acedata.cloud/suno/audios",
        headers={
            "Authorization": f"Bearer {API_TOKEN}",
            "Content-Type": "application/json",
        },
        json={
    "action": "generate",
    "prompt": "A cheerful pop song about summer vacation",
    "model": "chirp-v5",
    "custom": false
},
    )
    return response.json()

result = call_suno()
print(result)

​
Лучшие практики

  • Повторные попытки при ошибках: реализуйте экспоненциальное ожидание при ошибках 429 (ограничение скорости) и 5xx
  • Асинхронная обработка: для долгих задач (генерация изображений/видео) используйте callback_url для асинхронного получения результатов
  • Контроль затрат: отслеживайте использование и расходы через консоль Ace Data Cloud
  • Безопасность Token: храните API Token в переменных окружения, не вшивайте в код

​
Полезные ссылки