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: 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 额度。