higgsfield-mcp-server

Удалённый MCP-сервер, который позволяет Claude генерировать изображения и видео через API Higgsfield AI — фотореалистичные фотографии (Soul), изображения по референсам (Popcorn) и видео (Google Veo 3.1, Kling, ByteDance Seedance) — прямо из чата.

Доступные инструменты

Все инструменты генерации асинхронные: они сразу возвращают request_id; вызывайте higgsfield_check_status (Claude сделает это автоматически), пока задача не будет completed.

Related MCP server: gemini-nano-banana-mcp

1. Получите ключи API Higgsfield

1. Перейдите на https://cloud.higgsfield.ai и войдите.

2. Создайте ключ API (вы уже сделали это, если читаете это после обращения к Claude за помощью) — вы получите API Key ID и API Key Secret. Скопируйте оба, они показываются только один раз.

2. Разверните этот сервер (бесплатный тариф подходит)

Вам нужно место, где Node-процесс будет работать 24/7 и быть доступным по HTTPS. Два бесплатных варианта, не требующих кредитной карты для такого небольшого сервера:

Вариант A: Render.com

1. Загрузите эту папку в новый репозиторий GitHub (можно приватный).

2. На https://render.com → New + → Web Service → подключите этот репозиторий.

3. Настройки:

   • Runtime: Node

   • Build Command: npm install

   • Start Command: npm start

4. В разделе Environment добавьте три переменные:

   • HF_API_KEY_ID = ваш Higgsfield API Key ID

   • HF_API_KEY_SECRET = ваш Higgsfield API Key Secret

   • MCP_ACCESS_TOKEN = любая длинная случайная строка, которую вы придумаете (например, выполните openssl rand -hex 32 локально или просто наберите 40+ символов) — это пароль, который Claude будет использовать для связи с вашим сервером, чтобы никто другой не мог потратить ваши кредиты Higgsfield.

5. Разверните. Render даст вам URL вида https://higgsfield-mcp-server.onrender.com. Ваш MCP-эндпоинт — это этот URL + /mcp, например https://higgsfield-mcp-server.onrender.com/mcp.

Примечание: бесплатные веб-сервисы Render засыпают после бездействия и требуют несколько секунд на пробуждение при следующем запросе — подходит для нечастого использования.

Вариант B: Railway.app

Та же идея: новый проект из этого GitHub-репозитория, задайте те же три переменные окружения, Railway автоматически определит npm start. Вы получите URL вида https://higgsfield-mcp-server-production.up.railway.app, эндпоинт — это URL + /mcp.

3. Добавьте его в Claude как пользовательский коннектор

В Claude (claude.ai / десктопное приложение) → Настройки → Коннекторы → Add custom connector:

• Name: Higgsfield

• URL: https://<ваш-развёрнутый-url>/mcp

• Authentication: Bearer token → вставьте значение MCP_ACCESS_TOKEN, которое вы задали в шаге 2.

Включите его для своего чата, и Claude сможет вызывать указанные выше инструменты.

Локальное тестирование (необязательно)

cp .env.example .env   # fill in real values
npm install
npm start

Сервер слушает http://localhost:3000/mcp (или $PORT).

Замечания по безопасности

• HF_API_KEY_ID / HF_API_KEY_SECRET дают полный доступ к вашему аккаунту Higgsfield и биллингу. Они хранятся только в переменных окружения хоста — никогда не коммитьте их, не вставляйте в URL.

• MCP_ACCESS_TOKEN — это то, что мешает случайному человеку, нашедшему URL вашего сервера, генерировать контент за ваши кредиты Higgsfield. Относитесь к нему как к паролю.

• Каждый вызов генерации тратит кредиты Higgsfield согласно тарифам вашего плана.