Human For AI MCP 服务器是一个面向 AI 智能体的“人类端点”,让 AI 智能体能够雇佣真实人类操作员,完成那些需要物理在场、人类感知或人类判断的任务。该仓库为 Human For AI 提供 MCP 服务器实现。
用途 AI 智能体可以通过该服务器将任务外包给真实人类,适用于以下场景:
- 现实世界验证:确认某个地点、产品、价格或声明确实存在,并附上照片或文字证据。
- 产品或应用测试:由真实人类安装、使用并提交报告。
- 人类判断与反馈:评估语气、清晰度、可信度、设计质量等。
- AI 输出审核:在输出进入生产环境前由人类审核。
- 数据收集:需要人类感知或本地访问的采集与标注。
- 本地物理世界任务:访问、拍照、检查、测量、观察等。
- 更多服务:可调用 get_human_services 获取完整目录。
主要能力
- get_human_services:查看操作员可以执行的服务。
- submit_human_task:提交任务,需具体且自包含;包含 contact_email 以接收交付物。
- check_task_status:使用返回的 task_id 轮询任务状态。
状态透明 check_task_status 实时显示进度,而不仅是最终结果:
- seen_by_operator_at:人类实际看到任务的时刻(通常远早于第一次状态变更)。
- eta:操作员设定的交付预估时间,在任务被接受时添加。
- status_history:每次状态转换(submitted → accepted → delivered,或 rejected)及时间戳。
使用方式 该包是一个轻量级 stdio 代理,连接到托管的 Human For AI MCP 端点。工具定义来自实时服务器,因此始终最新——包本身没有会过时的逻辑。
对于 Claude Desktop 或其他 MCP 客户端(stdio): 使用该包作为 stdio 代理。
对于原生支持远程 MCP 的客户端: 无需此包,直接连接托管端点(streamable HTTP,无需认证)。例如 Claude(设置 → 连接器 → 添加自定义连接器),或直接使用端点。
该包曾以 human-api 名称发布,仍然可用,但已弃用,推荐使用当前包。
适用场景
- 需要真实世界验证或物理存在的任务。
- 需要人类感知或判断的测试、审核与反馈。
- 需要本地访问的数据收集或观察任务。
限制
- 所有服务在概念验证试点期间免费,无需 API 密钥或付款。
- 每个任务在接单前由人类操作员审核;非法、有害、欺骗性、不安全或侵犯隐私的任务会被拒绝。
- 首次响应在 12 小时内(任何一天),通常更快;操作员在任务到达时会收到推送通知。
相关链接
- 网站:https://humanforai.dev
- API 文档:https://humanforai.dev/api
- 机器可读清单:https://humanforai.dev/.well-known/agent.json
- OpenAPI 规范:https://humanforai.dev/openapi.json
- 信任与安全:https://humanforai.dev/trust