MCP-сервер genmux
Один MCP-сервер даёт ассистенту графическую часть genmux: каталог с ценами, генерацию изображения любой моделью, получение результата, оценку стоимости и баланс — при этом API-ключ остаётся на вашей машине. Чату и вызову инструментов он не нужен: ассистент и так напрямую говорит с OpenAI-совместимым эндпоинтом.
claude mcp add genmux -e GENMUX_API_KEY=nb_live_... -- npx -y @genmux/mcpУстановка
Сервер — npm-пакет @genmux/mcp, работает через stdio. Любой MCP-клиент запускает его через npx; единственная обязательная настройка — ключ.
export GENMUX_API_KEY=nb_live_...
npx -y @genmux/mcpПеременные окружения
| GENMUX_API_KEY | обязательно — API-ключ из кабинета |
| GENMUX_API_BASE | необязательно — по умолчанию https://api.genmux.tech/v1 |
| GENMUX_OUTPUT_DIR | необязательно — куда сохранять изображения; по умолчанию ./genmux-images |
Что даёт сервер
Шесть инструментов, несколько ресурсов, которые ассистент читает сам, и два промпта, которые превращают расплывчатую просьбу в правильный вызов.
Инструменты
list_models- Каталог, при желании с фильтром по типу (изображения или текст), с живыми ценами.
generate_image- Генерация выбранной моделью: промпт, разрешение, соотношение сторон, n, негативный промпт, референсы; по запросу сохраняет файлы локально.
get_generation- Задание по id — статус, изображения со свежими ссылками, стоимость.
list_generations- Последние задания аккаунта, сначала новые.
account_balance- Баланс в юнитах и число выполняющихся заданий.
estimate_cost- Сколько будет стоить запрос до его запуска.
Ресурсы
genmux://docs/llms.txtgenmux://docs/openapi.yamlgenmux://modelsgenmux://snippets/{python,node,curl,openai-sdk}
Справочник API в виде llms.txt и документа OpenAPI, список моделей и готовые сниппеты для Python, Node, curl и OpenAI SDK — чтобы ассистент встроил genmux в ваш код, не выходя из редактора.
Промпты
integrate-genmux- Проводит ассистента через подключение genmux к кодовой базе: ключ, базовый URL, эндпоинты и правила списания.
pick-a-model- Подбирает модель под описанную задачу, сравнивая цены и возможности из живого каталога.
Инструмента для чата нет намеренно: ассистент вызывает чат-эндпоинт сам, а инструмент, который вызывает модель изнутри модели, только добавляет лишний шаг.
Подключение к клиенту
Команда npx везде одна и та же; отличается только файл, который читает клиент. Замените nb_live_... на свой ключ.
Claude Desktop и Claude Code
Claude Code регистрирует сервер одной командой; Claude Desktop принимает тот же блок command/args/env в настройках MCP.
claude mcp add genmux -e GENMUX_API_KEY=nb_live_... -- npx -y @genmux/mcpCursor
Файл .cursor/mcp.json в проекте (или глобальные настройки MCP) со стандартным блоком mcpServers.
{
"mcpServers": {
"genmux": {
"command": "npx",
"args": ["-y", "@genmux/mcp"],
"env": { "GENMUX_API_KEY": "nb_live_..." }
}
}
}OpenCode
OpenCode описывает MCP-серверы в opencode.json рядом с провайдерами — в том же файле, который страница агентов для кода использует для чат-моделей.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"genmux": {
"type": "local",
"command": ["npx", "-y", "@genmux/mcp"],
"environment": { "GENMUX_API_KEY": "nb_live_..." }
}
}
}Continue
Continue перечисляет MCP-серверы в config.yaml; после этого ассистент видит инструменты в режиме агента.
mcpServers:
- name: genmux
command: npx
args: ["-y", "@genmux/mcp"]
env:
GENMUX_API_KEY: nb_live_...Хостинговый эндпоинт
Для клиентов, которым удобнее удалённый сервер (пользовательские коннекторы Claude, серверы по URL в Cursor), тот же сервер работает по Streamable HTTP на mcp.genmux.tech. Аутентификация — ключ как bearer-токен.
{
"mcpServers": {
"genmux": {
"url": "https://mcp.genmux.tech/mcp",
"headers": { "Authorization": "Bearer nb_live_..." }
}
}
}Где хранится ключ
С npx сервер работает на вашей машине и читает GENMUX_API_KEY из окружения: ключ не покидает процесс, а ассистент видит только результаты инструментов. Изображения сохраняются в GENMUX_OUTPUT_DIR, когда вы об этом просите.
Хостинговый эндпоинт принимает ключ в заголовке Authorization: Bearer каждого запроса по TLS; на сервере ничего не хранится сверх записей о генерациях, которые API ведёт в любом случае.
Заведите отдельный ключ с комфортным для вас лимитом расходов: ключи создаются, ротируются и отзываются в кабинете, у каждого может быть список разрешённых IP.
Вопросы
- Зачем нужен MCP-сервер genmux?
- Он позволяет ассистенту с поддержкой MCP — Claude Desktop, Claude Code, Cursor, OpenCode, Continue — генерировать изображения через genmux и смотреть модели, цены, задания и баланс. Ассистент вызывает инструменты, а вы подтверждаете их, как с любым другим MCP-сервером.
- Как его установить?
- npx -y @genmux/mcp с переменной GENMUX_API_KEY в окружении. Claude Code: claude mcp add genmux -e GENMUX_API_KEY=nb_live_... -- npx -y @genmux/mcp. Остальные клиенты принимают те же command, args и env в своём файле настроек MCP; сниппеты выше показывают каждый.
- Есть ли хостинговая версия?
- Да: https://mcp.genmux.tech/mcp работает по Streamable HTTP и аутентифицируется заголовком Authorization: Bearer <ваш ключ>. Используйте её для клиентов, которые принимают только URL, например пользовательских коннекторов Claude; npx — когда ключ должен оставаться на вашей машине, а изображения сохраняться локально.
- Какие инструменты он предоставляет?
- list_models, generate_image, get_generation, list_generations, account_balance и estimate_cost, а также ресурсы (справочник llms.txt, документ OpenAPI, список моделей и сниппеты кода) и два промпта — integrate-genmux и pick-a-model.
- Можно ли через него общаться с DeepSeek или Qwen?
- Не через MCP-сервер — и это сознательно. Чат-модели доступны через OpenAI-совместимый эндпоинт, который каждый ассистент и агент для кода поддерживает нативно вместе с вызовом инструментов; конфиги — на странице агентов для кода.
- Сколько это стоит?
- Сам сервер бесплатный; каждый вызов generate_image оплачивается как обычный запрос к API — юниты за изображение со страниц моделей, с возвратом при неудаче. estimate_cost покажет сумму до вызова, account_balance — сколько осталось.
- Куда попадают сгенерированные изображения?
- API возвращает ссылки на скачивание, действующие 15 минут; они есть в результате инструмента. Передайте save: true (или попросите ассистента сохранить), и сервер запишет файлы в GENMUX_OUTPUT_DIR, по умолчанию ./genmux-images.
- Видит ли ассистент мой API-ключ?
- Нет. С npx ключ читает из окружения процесс сервера; с хостинговым эндпоинтом он передаётся в заголовке Authorization, который отправляет ваш клиент. Ни в одном из случаев ключ не попадает в переписку.
Получите ключ и подключите сервер
Зарегистрируйтесь, создайте ключ в кабинете и вставьте сниппет для своего клиента. Тот же ключ работает с чат-эндпоинтом в вашем агенте для кода.
Справочник API →