Skip to main content
Glama

higgsfield-mcp-server

远程 MCP 服务器,让 Claude 通过 Higgsfield AI API 生成图像和视频 — 照片级逼真的照片(Soul)、参考图引导的图像(Popcorn)和视频(Google Veo 3.1、Kling、ByteDance Seedance)— 直接在聊天中完成。

公开的工具

工具

功能

higgsfield_generate_photo

文生图,照片级逼真(Soul/Standard)

higgsfield_generate_image_with_references

文生图,最多支持 8 张参考照片(Popcorn/Auto)

higgsfield_generate_video

通过 Google Veo 3.1 实现文本/图像/帧/参考图生成视频

higgsfield_generate_video_kling

通过 Kling v2.1 / v2.5 生成电影级视频

higgsfield_generate_video_seedance

通过 ByteDance Seedance 快速/低成本生成视频

higgsfield_check_status

轮询生成任务直到完成

higgsfield_cancel_request

取消排队中的任务

higgsfield_list_models

列出所有可用的端点(包括只能通过 raw_request 访问的端点)

higgsfield_raw_request

调用任何其他 Higgsfield 端点(Soul 角色/参考图、FLUX Kontext、MiniMax Hailuo、DOP)

所有生成工具都是异步的:它们会立即返回一个 request_id;调用 higgsfield_check_status(Claude 会自动执行此操作)直到任务 completed。

Related MCP server: higgsfield-mcp

1. 获取你的 Higgsfield API 密钥

  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 会给你一个类似 https://higgsfield-mcp-server.onrender.com 的 URL。你的 MCP 端点就是该 URL + /mcp,例如 https://higgsfield-mcp-server.onrender.com/mcp。

注意:Render 的免费 Web 服务在无活动时会休眠,下次请求时需要几秒钟唤醒 — 对于偶尔使用来说没问题。

选项 B:Railway.app

思路相同:从这个 GitHub 仓库新建项目,设置相同的三个环境变量,Railway 会自动检测 npm start。你会得到一个类似 https://higgsfield-mcp-server-production.up.railway.app 的 URL,端点是该 URL + /mcp。

3. 将其作为自定义连接器添加到 Claude

在 Claude(claude.ai / 桌面应用)中 → 设置 → 连接器 → 添加自定义连接器:

  • 名称:Higgsfield

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

  • 身份验证:Bearer token → 粘贴你在第 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 额度。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers