Сервер GenMagic MCP

Один сервер Model Context Protocol, который позволяет любому AI-агенту генерировать текст, изображения, речь, музыку и видео, используя единый баланс предоплаченных средств.

GenMagic — это единая студия и единый API для работы с генеративными AI-моделями любых типов и форматов. Этот репозиторий содержит инструкции по подключению и описание сервера в реестре для удалённого MCP-сервера. Укажите один URL в любом MCP-клиенте, добавьте свой ключ — и агент получит шесть инструментов генерации и list_models. Он сможет выбрать любую из более чем 450 моделей GenMagic (GPT, Claude, Gemini, Veo, Kling, Seedance, FLUX, Recraft и других) по идентификатору или предоставить выбор GenMagic.

Endpoint: https://genmagic.co/api/mcp
Транспорт: Streamable HTTP (stateless JSON-RPC)
Версия: 1.1.1
Аутентификация: Authorization: Bearer gm_live_... (создайте ключ на https://genmagic.co/get-api-key)
Хостинг: ничего не нужно устанавливать или запускать — сервер уже доступен удалённо.
Реестр: сервер внесён в официальный реестр MCP под идентификатором io.github.yumaheymans/genmagic (см. server.json).

Инструменты

Инструмент	Назначение
`list_models`	Актуальный каталог моделей, отсортированный от новых к старым. Для каждой модели указаны идентификатор, цена и основные сведения: размер контекстного окна и возможности для текста, голоса для речи, разрешения, длительность клипов и звук для видео. Поддерживаются фильтры `category`, `search` и `capability`. Ключ не требуется.
`generate_text`	Генерация текста, кода, графики SVG или полноценной веб-страницы (необязательные параметры `type` и `model`).
`generate_image`	Создание или редактирование изображения; для логотипа используйте `type=logo`. Параметр `model` необязателен.
`generate_speech`	Озвучивание текста с точным сохранением исходной формулировки; параметры `model` и `voice` необязательны.
`generate_music`	Создание оригинальной музыкальной композиции по описанию; параметр `model` необязателен.
`create_video`	Запуск асинхронной задачи генерации видео с помощью любой модели text-to-video. Поддерживаются параметры `duration`, `resolution` и `generate_audio`. Инструмент возвращает идентификатор задачи и пока не списывает средства.
`get_video`	Проверка состояния задачи генерации видео. Средства списываются один раз — после завершения задачи.

Каждый инструмент генерации принимает необязательный идентификатор модели model из списка list_models. Если модель не поддерживает нужный тип результата, запрос будет отклонён со ссылкой на list_models: система не заменит её другой моделью. Если не указывать model, GenMagic выберет подходящий вариант с выгодной стоимостью.

Вызовы initialize, ping, tools/list и list_models доступны без ключа; для инструментов генерации ключ обязателен. Результат каждого инструмента содержит сведения о расходах в ключе MCP _meta genmagic.ai/usage: использованная модель (model), стоимость (cost_cents), остаток средств (credits_remaining) и объект с тарифом (rate). Благодаря этому агент может контролировать темп генерации и бюджет, используя данные уже полученного результата.

Подключение

Создайте ключ на https://genmagic.co/get-api-key (зарегистрируйтесь бесплатно и подтвердите адрес электронной почты), затем добавьте сервер в клиент.

Claude Code

claude mcp add --transport http genmagic https://genmagic.co/api/mcp \
  --header "Authorization: Bearer gm_live_your_key"

VS Code

Для установки в один клик откройте https://genmagic.co/developers#mcp и выберите Add to VS Code. VS Code один раз запросит ключ и сохранит его как секрет. Либо добавьте сервер в .vscode/mcp.json вручную:

{
  "inputs": [
    { "type": "promptString", "id": "genmagic-api-key", "description": "GenMagic API key", "password": true }
  ],
  "servers": {
    "genmagic": {
      "type": "http",
      "url": "https://genmagic.co/api/mcp",
      "headers": { "Authorization": "Bearer ${input:genmagic-api-key}" }
    }
  }
}

Cursor, Windsurf и большинство клиентов

Добавьте запись genmagic в конфигурацию MCP (.cursor/mcp.json или соответствующий файл клиента). В Cursor также доступна установка в один клик: выберите Add to Cursor на странице https://genmagic.co/developers#mcp.

{
  "mcpServers": {
    "genmagic": {
      "url": "https://genmagic.co/api/mcp",
      "headers": { "Authorization": "Bearer gm_live_your_key" }
    }
  }
}

Claude Desktop

Добавьте GenMagic как пользовательский коннектор в разделе Settings → Connectors, указав URL https://genmagic.co/api/mcp и заголовок Authorization: Bearer gm_live_your_key.

Любой клиент JSON-RPC (напрямую)

Сервер использует обычный JSON-RPC поверх HTTP, поэтому с ним можно работать через curl:

# List the tools (no key required)
curl https://genmagic.co/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

# Generate an image (key required)
curl https://genmagic.co/api/mcp \
  -H "Authorization: Bearer gm_live_your_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "a cobalt prism refracting into a spectrum, dark studio, 3D render", "size": "1024x1024" }
    }
  }'

Как работает тарификация

Отдельного счётчика для агентов нет. При каждой генерации — в студии, через REST API или MCP-сервер — фактическая стоимость услуг поставщика модели списывается с единого предоплаченного баланса в USD (1 кредит = 1 цент США). После подтверждения адреса электронной почты новый аккаунт однократно получает стартовый баланс $0.50; он предоставляется один раз на человека. Баланс можно пополнить на сумму от $5 до $100 с шагом $5 или оформить подписку с регулярно обновляемым балансом, бонусом для подписчиков и правами на коммерческое использование. Вызовы create_video и get_video, пока видео ещё рендерится, ничего не стоят: стоимость клипа списывается при проверке состояния, которая подтверждает завершение задачи. Подробнее: https://genmagic.co/pricing.

Генерация в фирменном стиле

Один раз включите персонализацию в приложении — подключите сайт или профиль LinkedIn. После этого результаты каждого вызова инструмента будут учитывать голос бренда, целевую аудиторию и цвета, без необходимости менять запросы. В результатах визуальных инструментов также указывается оценка brand_fit, чтобы агент мог повторно сгенерировать материалы, отклонившиеся от фирменной палитры.

Ссылки

Студия: https://genmagic.co · Ключ API: https://genmagic.co/get-api-key
Полная документация по API и MCP: https://genmagic.co/developers
Данные для автоматического обнаружения: /.well-known/mcp.json · /llms.txt · /openapi.json
Цены: https://genmagic.co/pricing

Лицензия

MIT. См. LICENSE. Этот репозиторий содержит документацию по подключению и описание сервера в реестре; сервис GenMagic работает на genmagic.co.