@firsthandapi/mcp-server — FirstHandAPI MCP 服务器

从零到上岗（引导模式）

还没有 API 密钥？照样可以启动服务器——它会暴露一个 signup 工具：

npx @firsthandapi/mcp-server        # no env var needed

调用 signup 并传入 org_name 和 email，即可获得 API 密钥和 $2.50 的免费额度（密钥只显示一次——请保存好），然后配置好密钥重新启动：

claude mcp add firsthandapi -e FIRSTHAND_API_KEY=fh_live_... -- npx @firsthandapi/mcp-server

配置好密钥后，全部 7 个任务工具即可解锁：create_job、create_job_and_wait、get_job、list_jobs、get_job_files、cancel_job、get_credits。

FirstHandAPI 的官方 MCP 服务器——人机协同（HITL）众包数据采集。让 Claude Code、Cursor 及其他 AI 代理能够从真实人类工作者那里采集照片、音频、视频和屏幕录制，并带有自动化 AI 质量评分。

适用场景：UGC 采集、用于 AI 评估的真实数据、多模态模型的 LLM 训练数据。

Related MCP server: simple-fal-mcp

安装

npm install @firsthandapi/mcp-server

配置

Claude Code

{
  "mcpServers": {
    "firsthand": {
      "command": "npx",
      "args": ["@firsthandapi/mcp-server"],
      "env": {
        "FIRSTHAND_API_KEY": "fh_live_your_key_here"
      }
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "firsthand": {
    "command": "npx @firsthandapi/mcp-server",
    "env": { "FIRSTHAND_API_KEY": "fh_live_..." }
  }
}

工具

所有任务创建工具都接受一个可选的 location 参数：基于文本的 { city, state } 或基于坐标的 { latitude, longitude, radius_km } 约束。

环境变量

• FIRSTHAND_API_KEY（必填）——你的 API 密钥

• FIRSTHAND_BASE_URL（可选）——API 基础地址（默认：https://api.firsthandapi.com）

• FIRSTHAND_TIMEOUT_MS（可选）——请求超时时间（默认：30000）

许可证

专有