higgsfield-mcp-server

远程 MCP 服务器，让 Claude 可以通过 Higgsfield AI API 生成图片和视频——照片级真实感图片（Soul）、参考图引导图片（Popcorn）以及视频（Google Veo 3.1、Kling、ByteDance Seedance）——直接在对话中完成。

暴露的工具

所有生成工具都是异步的：它们会立即返回一个 request_id；请调用 higgsfield_check_status（Claude 会自动执行此操作）直到任务状态为 completed。

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. 部署此服务器（免费套餐即可）

你需要一个能 24/7 保持 Node 进程运行且可通过 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://<你的部署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 额度。