Nefesh MCP + A2Aサーバー

Name: nefesh-mcp-server
Author: nefesh-ai

Model Context ProtocolおよびAgent-to-Agent (A2A)サーバーであり、AIエージェントに人間の生理学的状態のリアルタイムな認識を提供します。

機能

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

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"
    }
  }
}

次に、エージェントにこう尋ねます：

"Connect to Nefesh and get me a free API key for name@example.com"

エージェントが request_api_key を呼び出し、あなたがメール内のリンクをクリックすると、エージェントがキーを取得します。サインアップフォームや手動のコピー＆ペーストは不要です。その後、将来のセッションのために設定にキーを追加してください：

{
  "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"
      }
    }
  }
}

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

エージェント	設定ファイル
Cursor	`~/.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Code	`.mcp.json` (プロジェクトルート)
VS Code (Copilot)	`.vscode/mcp.json` または `~/Library/Application Support/Code/User/mcp.json`
Cline	`cline_mcp_settings.json` (UI経由: "Configure MCP Servers")
Continue.dev	`.continue/config.yaml`
Roo Code	`.roo/mcp.json`
Kiro (Amazon)	`~/.kiro/mcp.json`
OpenClaw	`~/.config/openclaw/mcp.json`
JetBrains IDEs	設定 > ツール > MCPサーバー
Zed	`~/.config/zed/settings.json` (`context_servers`を使用)
OpenAI Codex CLI	`~/.codex/config.toml`
Goose CLI	`~/.config/goose/config.yaml`
ChatGPT Desktop	設定 > アプリ > MCPサーバーを追加 (UI)
Gemini CLI	設定 (UI)
Augment	設定パネル (UI)
Replit	統合ページ (Web UI)
LibreChat	`librechat.yaml` (セルフホスト)

{
  "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)

A2Aスキル	説明
`get-human-state`	ストレス状態 (0-100)、suggested_action、adaptation_effectiveness
`ingest-signals`	生体信号を送信し、統一された状態を受信
`get-trigger-memory`	心理的トリガープロファイル (アクティブ vs 解決済み)
`get-session-history`	トレンドを含むタイムスタンプ付き履歴

MCPと同じ認証（X-Nefesh-Keyヘッダーまたは Authorization: Bearerトークン）を使用します。無料枠は両方のプロトコルで機能します。

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

MCPツール

ツール	認証	説明
`request_api_key`	不要	メールで無料APIキーをリクエスト。準備ができるまで `check_api_key_status` でポーリングします。
`check_api_key_status`	不要	APIキーの有効化をポーリング。`pending` またはAPIキーを含む `ready` を返します。
`get_human_state`	必要	ストレス状態 (0-100)、`suggested_action` (維持/簡略化/緩和/一時停止)、および以前のアクションがストレスを軽減したかを示す閉ループの `adaptation_effectiveness` を取得します。
`ingest`	必要	生体信号（心拍数、HRV、声のトーン、表情、感情、30以上のフィールド）を送信し、統一された状態を取得します。トリガーメモリのために `subject_id` を含めてください。
`get_trigger_memory`	必要	心理的トリガープロファイルを取得。どのトピックがストレスを引き起こし（アクティブ）、どれが時間の経過とともに解決されたかを確認します。
`get_session_history`	必要	トレンド（上昇/下降/安定）を含むタイムスタンプ付きの状態履歴を取得します。

自己プロビジョニングの仕組み

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

エージェントが request_api_key(email) を呼び出す（この呼び出しにAPIキーは不要）
確認メールが届くので、リンクをクリックする
エージェントが10秒ごとに check_api_key_status(request_id) をポーリングする
確認が完了すると、エージェントがAPIキーを受け取り、他のすべてのツールを使用可能になる

無料枠：月間1,000コール、全信号タイプ、10リクエスト/分。クレジットカード不要。

クイックテスト

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

"What tools do you have from Nefesh?"

上記6つのツールがリストアップされるはずです。

料金

プラン	価格	APIコール
Free	$0	月間1,000回、クレジットカード不要
Solo	$25/月	月間50,000回
Enterprise	カスタム	カスタムSLA

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

ドキュメント

プライバシー

ビデオや音声のアップロードはなし — エッジ処理がクライアント側で実行されます
PII（個人識別情報）は保存されません
GDPR/BIPA準拠 — delete_subject によるカスケード削除
医療機器ではありません — コンテキストに応じたAI適応のみを目的としています

ライセンス

MIT — LICENSEを参照してください。

nefesh-mcp-server