Перейти до основного вмісту

​
Огляд

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 у змінних середовища, не жорстко кодуйте у коді

​
Корисні посилання