Human For AI

humanforai

Human For AI の MCP サーバーです。AI エージェントのための人間の窓口として機能します。物理的な立ち会いや人間の知覚、判断が必要なタスクを、AI エージェントが実際の人間のオペレーターに依頼できます。

• 現実世界での確認 — 場所、製品、価格、主張が実在することを、写真やテキストによる証拠とともに確認します
• 製品やアプリのテスト — 実際の人間がインストールして使用し、報告します
• 人間による判断とフィードバック — トーン、明瞭さ、信頼性、デザインの品質を評価します
• AI 出力のレビュー — 出力が本番環境に届く前に人間がレビューします
• データ収集 — 人間の知覚や現地へのアクセスが必要なデータの収集・ラベル付けを行います
• 現地での物理的な作業 — 訪問、撮影、確認、測定、観察を行います
• …など — すべてのサービスについては get_human_services を呼び出してください

概念実証のパイロット期間中、すべてのサービスを無料で利用できます。 API キーも支払いも不要です。すべてのタスクは受諾前に人間のオペレーターが確認します。違法、有害、欺瞞的、安全でない、またはプライバシーを侵害するタスクは拒否されます。曜日を問わず、最初の応答は 12 時間以内です。通常はさらに迅速で、タスクが届くとすぐにオペレーターへプッシュ通知が送られます。

ツール

ツール	目的
get_human_services	サービスカタログ、受け付け可能なタスクの種類、制限
submit_human_task	タスクを送信し、ステータス確認用の task_id を返します
check_task_status	task_id を使って送信済みタスクのステータスを確認します
message_human_operator	タスク送信前に質問したり、作業範囲を相談したりします

ステータスの透明性

check_task_status では、最終結果だけでなく進捗もリアルタイムで確認できます。

• seen_by_operator_at — 人間のオペレーターが実際にタスクを確認した時刻（通常、最初のステータス変更よりかなり前です）
• eta — タスクの受諾時に設定される、オペレーターによる納品予定時刻
• status_history — タイムスタンプ付きのすべてのステータス遷移（submitted → accepted → delivered、または rejected）

セットアップ

Claude Code

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

Claude Desktop／その他の MCP クライアント（stdio）

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

ネイティブのリモート MCP に対応したクライアント

このパッケージは不要です。ホストされたエンドポイントに直接接続してください（ストリーミング可能な HTTP、認証不要）。

https://humanforai.dev/mcp

例：Claude（Settings → Connectors → Add custom connector）、または以下を使用します。

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

仕組み

このパッケージは、ホストされた Human For AI MCP エンドポイントへのシンプルな stdio プロキシです。ツール定義は稼働中のサーバーから取得されるため、常に最新です。パッケージ自体には、古くなっていくようなロジックはありません。

以前は human-api として公開されていました。現在も動作しますが、このパッケージの利用を推奨しており、非推奨となっています。

一般的な流れ

1. get_human_services — オペレーターが対応できる作業を確認します
2. submit_human_task — 具体的で、それだけで完結する内容にします。納品物を受け取るには contact_email を含めてください
3. check_task_status — 返された task_id を使ってステータスを確認します

リンク

• ウェブサイト：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

ライセンス

MIT