higgsfield-mcp-server

Claude が Higgsfield AI API を通じて画像や動画を生成できるようにするリモート MCP サーバー — フォトリアルな写真 (Soul)、参照画像による画像生成 (Popcorn)、動画生成 (Google Veo 3.1、Kling、ByteDance Seedance) — をチャットから直接行えます。

公開されているツール

すべての生成ツールは非同期です。即座に request_id を返し、ジョブが completed になるまで higgsfield_check_status を呼び出します (Claude が自動的に行います)。

Related MCP server: gemini-nano-banana-mcp

1. Higgsfield API キーを取得する

1. https://cloud.higgsfield.ai にアクセスしてサインインします。

2. API キーを作成します (Claude に助けを求めた後にこれを読んでいるなら、すでに作成済みです) — API Key ID と API Key Secret が発行されます。両方をコピーしてください。これらは一度しか表示されません。

2. このサーバーをデプロイする (無料枠で動作します)

Node プロセスを24時間365日稼働させ、HTTPS で到達可能な場所が必要です。このような小規模サーバー向けに、クレジットカード不要の無料オプションが2つあります:

オプション A: Render.com

1. このフォルダを新しい GitHub リポジトリにプッシュします (プライベートで構いません)。

2. https://render.com で 新規 + → Web サービス → そのリポジトリを接続します。

3. 設定:

   • ランタイム: Node

   • ビルドコマンド: npm install

   • 開始コマンド: npm start

4. 環境 で、次の3つの変数を追加します:

   • 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 は https://higgsfield-mcp-server.onrender.com のような URL を発行します。MCP エンドポイントはその URL + /mcp です。例: https://higgsfield-mcp-server.onrender.com/mcp。

注: Render の無料 Web サービスは非アクティブ状態が続くとスリープし、次のリクエストで起動するまで数秒かかります — たまに使う分には問題ありません。

オプション B: Railway.app

同じ考え方です: この GitHub リポジトリから新しいプロジェクトを作成し、同じ3つの環境変数を設定します。Railway は npm start を自動検出します。https://higgsfield-mcp-server-production.up.railway.app のような URL が発行され、エンドポイントはそれ + /mcp です。

3. カスタムコネクタとして Claude に追加する

Claude (claude.ai / デスクトップアプリ) で → 設定 → コネクタ → カスタムコネクタを追加:

• 名前: Higgsfield

• URL: https://<your-deployed-url>/mcp

• 認証: Bearer トークン → 手順2で設定した MCP_ACCESS_TOKEN の値を貼り付けます。

チャットで有効にすると、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 クレジットを消費します。