Nefesh

Nefesh MCP + A2A サーバー

AI エージェントに人間の生理状態をリアルタイムで把握させる、Model Context Protocol および Agent-to-Agent (A2A) サーバーです。

できること

センサーデータ（心拍数、音声、表情、テキストのセンチメント）を送信すると、エージェントがそのまま実行できる機械可読なアクションを含む統合状態が返されます。プロンプトエンジニアリングは一切不要です。

セッション中の2回目以降の呼び出しでは、レスポンスに adaptation_effectiveness が含まれ、エージェントに以前のアプローチが実際に効果を発揮したかどうかを伝えます。自己改善するエージェントのためのクローズドループ型フィードバックシステムです。

適応効果（クローズドループ）

ほとんどの API は状態を返します。Nefesh は、その状態に対するエージェントの反応が実際に効果を発揮したかどうかを伝えます。

セッション中の2回目以降の呼び出しでは、すべてのレスポンスに次の内容が含まれます。

{
  "state": "focused",
  "stress_score": 45,
  "suggested_action": "simplify_and_focus",
  "adaptation_effectiveness": {
    "previous_action": "de-escalate_and_shorten",
    "previous_score": 68,
    "current_score": 45,
    "stress_delta": -23,
    "effective": true
  }
}

エージェントは effective: true を読み取り、以前の緊張緩和策が効果を発揮したと判断できます。effective: false の場合、エージェントは戦略を調整します。このフィードバックループを提供する人間の状態把握システムは、ほかにありません。

セットアップ

オプション A：まず接続し、エージェントを通じてキーを取得する（最速）

API キーなしで設定を追加してください。エージェントが自動的にキーを取得します。

{
  "mcpServers": {
    "nefesh": {
      "url": "https://mcp.nefesh.ai/mcp"
    }
  }
}

次に、エージェントにこう尋ねてください。

「メールアドレスを使って、無料の Nefesh API キーを取得してください」

エージェントが request_api_key を呼び出すので、メール内のリンクを1回クリックしてください。エージェントがキーを取得します。登録フォームへの入力も、手動でのコピー＆ペーストも不要です。その後、今後のセッションに備えて、設定にキーを追加してください。

{
  "mcpServers": {
    "nefesh": {
      "url": "https://mcp.nefesh.ai/mcp",
      "headers": {
        "X-Nefesh-Key": "nfsh_free_..."
      }
    }
  }
}

オプション B：先にキーを取得してから接続する

nefesh.ai/signup で登録し（毎月1,000回の呼び出し、クレジットカード不要）、キーを含む設定を追加してください。

{
  "mcpServers": {
    "nefesh": {
      "url": "https://mcp.nefesh.ai/mcp",
      "headers": {
        "X-Nefesh-Key": "YOUR_API_KEY"
      }
    }
  }
}

エージェント別の設定ファイル

{
  "servers": {
    "nefesh": {
      "type": "http",
      "url": "https://mcp.nefesh.ai/mcp",
      "headers": {
        "X-Nefesh-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

{
  "context_servers": {
    "nefesh": {
      "settings": {
        "url": "https://mcp.nefesh.ai/mcp",
        "headers": {
          "X-Nefesh-Key": "<YOUR_API_KEY>"
        }
      }
    }
  }
}

[mcp_servers.nefesh]
url = "https://mcp.nefesh.ai/mcp"

mcpServers:
  - name: nefesh
    type: streamable-http
    url: https://mcp.nefesh.ai/mcp

すべてのエージェントは Streamable HTTP 経由で接続します。ローカルへのインストールは不要です。

A2A 統合（Agent-to-Agent Protocol v1.0）

Nefesh は A2A 互換エージェントとしても利用できます。MCP がツール呼び出し（エージェントが Nefesh を呼び出す）を扱うのに対し、A2A はエージェント間の連携を可能にします。つまり、ほかの AI エージェントが Nefesh と対等な立場で通信できます。

エージェントカード： /.well-known/agent-card.json

A2A エンドポイント： POST https://mcp.nefesh.ai/a2a（JSON-RPC 2.0）

認証方法は MCP と同じです。X-Nefesh-Key ヘッダーまたは Authorization: Bearer トークンを使用します。無料プランはどちらのプロトコルでも利用できます。

ソース：nefesh-ai/nefesh-a2a · ドキュメント：nefesh.ai/docs/a2a

MCP ツール

セルフプロビジョニングの仕組み

AI エージェントは、無料の API キーを自律的に取得できます。ユーザーがクリックするのはメールのリンク 1 つだけです。

1. エージェントがユーザーに「メールアドレスを教えてください」と尋ねます。
2. エージェントが request_api_key(your_real_email) を呼び出します。この呼び出しに API キーは不要です。
3. ユーザーに確認メールが届き、リンクをクリックします。
4. エージェントが 10 秒ごとに check_api_key_status(your_real_email) をポーリングします。
5. 確認が完了すると、エージェントは API キーを受け取り、ほかのすべてのツールを利用できるようになります。

重要： エージェントは、実際にアクセスできるユーザー本人のメールアドレスを使用する必要があります。使い捨てメールアドレスはブロックされます。キーを有効化するには、ユーザー本人が確認リンクをクリックする必要があります。

無料プラン：月 1,000 回の呼び出し、すべての信号タイプに対応、10 req/min。クレジットカードは不要です。

クイックテスト

設定を追加した後、AI エージェントに次のように尋ねてください。

「Nefesh のどのツールを利用できますか？」

上記の 6 つのツールが一覧表示されます。

料金

CLI の代替手段

MCP よりもターミナルを使いたい場合は、Nefesh CLI をご利用ください（AI エージェントでは MCP よりトークンコストを 10～32 倍削減できます）。

npm install -g @nefesh/cli
nefesh ingest --session test --heart-rate 72 --tone calm
nefesh state test --json

GitHub：nefesh-ai/nefesh-cli

ゲートウェイの代替手段

AI に自動で適応させたい場合は、Nefesh Cognitive Compute Router をご利用ください。LLM のベース URL を gateway.nefesh.ai に変更すると、ゲートウェイが生体状態に応じてシステムプロンプトと温度を調整します。モードは 3 種類あります。OpenAI 互換（/v1/chat/completions）、Anthropic パススルー（/v1/messages）、および任意のバックエンドに対応する Unified Anthropic です。コードの変更は不要です。

GitHub：nefesh-ai/nefesh-gateway

Human State Protocol（HSP）

Nefesh は、AI システム間で人間の生理状態を交換するためのオープンな仕様である Human State Protocol を実装し、維持しています。HSP は、ストレススコア、行動に関する推奨事項、適応に関するフィードバックの標準 JSON 形式を定義しているため、あらゆるエージェントが人間の状態データを相互運用可能な形で生成または利用できます。Apache 2.0。

GitHub： nefesh-ai/human-state-protocol · ドキュメント： nefesh.ai/docs/hsp

ドキュメント

• API リファレンス全文
• クイックスタート
• 状態マッピング
• MCP サーバー · ソース
• A2A サーバー · ソース
• Cognitive Compute Router（ゲートウェイ） · ソース
• CLI · ソース
• Human State Protocol（HSP） · ソース
• A2A エージェントカード
• A2A プロトコル仕様

プライバシー

• 動画や音声のアップロードはありません — エッジ処理はクライアント側で実行されます
• 個人を特定できる情報（PII）は保存されません
• GDPR/BIPA に準拠 — delete_subject による連鎖削除に対応
• 医療機器ではありません — 文脈に応じた AI の適応のみを目的としています

ライセンス

MIT — LICENSE をご覧ください。