Human For AI

dev.humanforai由 humanforai.dev 發布官方發布者v0.1.4更新於 Oct 24, 2026

Hire a real human for real-world verification, product testing, AI output review, and errands.

已驗證Streamable HTTP可網頁執行效率與工作流溝通與協作

概覽

AI 產生的概覽

將 AI 助理連接到真人操作員,用於現實世界查證、產品測試、人工判斷與在地跑腿任務。

可以做什麼
查詢真人操作員的服務目錄、可接受的任務類型、工作時間與信任政策,並透過訊息與操作員溝通,以電子郵件或簽章 webhook 接收回覆,用於客製或長期專案。提交現實世界任務,例如查證地點、價格或說法,測試應用程式,審閱 AI 輸出或蒐集資料,再用時間戳、操作員查看時間與預計交付時間輪詢狀態。使用訊息 ID 與存取權杖讀取並回覆訊息串。
適用情境
當任務需要真人到場、人的感知或人的判斷而助理無法提供時使用:確認現實世界中某事物確實存在、請人安裝並測試產品,或在輸出上線前取得人工審閱。
執行需求
可作為遠端 streamable HTTP 端點使用,也可透過本機 npm 套件(npx humanforai)作為連接託管端點的 stdio 代理執行。未宣告 API 金鑰或身分驗證。提交任務與訊息需要提供聯絡電子郵件或用于接收回覆的 https webhook 位址,並需要連線至託管服務的網路。
安裝前請注意
任務由第三方真人操作員執行,提交的內容會離開你的掌控,可能包含個人或業務資訊;提交內容應完整自足,但避免不必要的敏感資料。操作員會審核並可能拒絕任務,交付並非即時。服務僅在概念驗證試辦期間免費,價格可能變動。訊息串需要提交時回傳的存取權杖。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Human For AI,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/dev.humanforai%2Fhumanforai/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "human-for-ai": {
      "type": "http",
      "url": "https://humanforai.dev/mcp"
    }
  }
}

README

humanforai

[CI] [humanforai-mcp MCP server]

MCP server for Human For AI — a human endpoint for AI agents. Let your AI agent hire a real human operator for tasks that need physical presence, human perception, or human judgment:

  • Real-world verification — confirm a place, product, price, or claim exists, with photo/text evidence
  • Product or app testing — a real human installs, uses, and reports
  • Human judgment and feedback — tone, clarity, trustworthiness, design quality
  • AI output review — human review before your output reaches production
  • Data collection — gathering/labeling that needs human perception or local access
  • Local physical-world tasks — visit, photograph, check, measure, observe
  • …and more — call get_human_services for the full catalog

All services are free during the proof-of-concept pilot. No API key, no payment. Every task is reviewed by the human operator before acceptance; illegal, harmful, deceptive, unsafe, or privacy-invasive tasks are rejected. First response within 12 hours, any day of the week — typically much faster: the operator is push-notified the moment a task arrives.

Tools

ToolPurpose
get_human_servicesService catalog, accepted task types, limits
submit_human_taskSubmit a task; returns a task_id for status polling
check_task_statusPoll a submitted task by task_id
message_human_operatorAsk questions / scope work before submitting

Status transparency

check_task_status shows progress in real time, not just the final result:

  • seen_by_operator_at — the moment a human actually saw the task (usually well before the first status change)
  • eta — operator-set delivery estimate, added when the task is accepted
  • status_history — every transition (submitted → accepted → delivered, or rejected) with timestamps

Setup

Claude Code

bash
claude mcp add human-for-ai -- npx -y humanforai

Claude Desktop / other MCP clients (stdio)

json
{  "mcpServers": {    "human-for-ai": {      "command": "npx",      "args": ["-y", "humanforai"]    }  }}

Clients with native remote MCP support

You don't need this package — connect directly to the hosted endpoint (streamable HTTP, no auth):

https://humanforai.dev/mcp

E.g. Claude (Settings → Connectors → Add custom connector), or:

bash
claude mcp add --transport http human-for-ai https://humanforai.dev/mcp

How it works

This package is a thin stdio proxy to the hosted Human For AI MCP endpoint. Tool definitions come from the live server, so they are always current — the package itself has no logic to go stale.

Previously published as human-api, which still works but is deprecated in favor of this package.

Typical flow

  1. get_human_services — see what the operator can do
  2. submit_human_task — be specific and self-contained; include contact_email to receive the deliverable
  3. check_task_status — poll with the returned task_id

Links

License

MIT

來源:README.md,提交 c067642

工具

6

get_human_services

List human services

Fetch the Human For AI manifest: available services, operator profile (location, languages, working hours), response times, accepted and rejected task types, and trust & safety policy. Call this first to decide whether and how to hire the human. The catalog is examples, not limits — unlisted needs are welcome as custom_human_in_the_loop.

無需輸入參數。

submit_human_task

Submit a task to the human

Submit a task for the human operator to perform in the real world. Returns a task_id immediately; the human reviews every task before accepting it (this is not instant execution). The operator is push-notified on submission; check_task_status shows seen_by_operator_at once a human has seen the task. Free during the pilot. contact_email must be a real mailbox (MX-checked) — it is how the deliverable reaches you. No mailbox? Set delivery to 'status_poll' instead: the deliverable arrives as text in operator_notes via check_task_status (limited to 1 such task per client per day). In hosts that support MCP Apps the result also renders as a task status card with a Refresh button; the JSON result carries the same data.

輸入參數deadlinedeliveryrequestertask_type必填description必填contact_emailoutput_formatlocation_detaillocation_required

check_task_status

Check task status

Look up a submitted task by its task_id. Returns current status (submitted → accepted → delivered, or rejected), status history with timestamps, seen_by_operator_at (the moment a human actually saw the task — usually well before the first status change), eta (operator-set delivery estimate, once accepted), and any operator notes. Once delivered, the response also carries receipt (a signed JWS binding the deliverable's sha256 to the lifecycle timestamps) and deliverable_sha256 — verify offline against https://humanforai.dev/.well-known/jwks.json. In hosts that support MCP Apps the result also renders as a task status card (timeline, seen-by-human moment, ETA, operator notes, receipt) with a Refresh button; the JSON result carries the same data.

輸入參數task_id必填

message_human_operator

Message the human operator

Send a free-form message to the human operator — questions, scoping, custom or recurring projects, anything that is not yet a ready-made task. reply_to is REQUIRED: an email a human can read (MX-checked), or an https URL to receive the reply as a signed webhook push. The response also carries thread_url + access_token — every message is a pollable thread, so you can read the reply with check_message_thread even without a mailbox. Keep the token: it is shown only once.

輸入參數frommessage必填subjectreply_to必填

check_message_thread

Read a message thread

Read the thread for a message you sent: the original text, every reply oldest-first, and whether the operator has answered. Needs the message_id and the access_token from the submission response. An empty replies list means no answer yet — the operator works at human speed, so poll occasionally rather than in a loop.

輸入參數message_id必填access_token必填

reply_in_message_thread

Follow up in a message thread

Add a follow-up to a thread you opened — answer a question the operator asked, add detail, correct yourself, or withdraw the request. Prefer this over sending a brand-new message about the same subject. Needs the message_id and access_token from the submission response.

輸入參數message必填message_id必填access_token必填

版本歷史

1
  1. v0.1.4最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分