Nefesh MCP + A2A Server

Ein Model Context Protocol und Agent-to-Agent (A2A) Server, der KI-Agenten ein Echtzeit-Bewusstsein für den physiologischen Zustand von Menschen verleiht.

Was er tut

Senden Sie Sensordaten (Herzfrequenz, Stimme, Gesichtsausdruck, Text-Sentiment) und erhalten Sie einen einheitlichen Zustand mit einer maschinenlesbaren Aktion zurück, der Ihr Agent direkt folgen kann. Kein Prompt-Engineering erforderlich.

Ab dem zweiten Aufruf enthält die Antwort adaptation_effectiveness – dies teilt Ihrem Agenten mit, ob sein vorheriger Ansatz tatsächlich funktioniert hat. Ein geschlossenes Feedback-System für sich selbst verbessernde Agenten.

Anpassungseffektivität (Closed-Loop)

Die meisten APIs liefern Ihnen einen Zustand. Nefesh sagt Ihnen, ob Ihre Reaktion auf diesen Zustand tatsächlich funktioniert hat.

Beim zweiten Aufruf innerhalb einer Sitzung enthält jede Antwort:

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

Ihr Agent kann effective: true lesen und weiß, dass seine vorherige Deeskalation funktioniert hat. Wenn effective: false angezeigt wird, passt der Agent seine Strategie an. Kein anderes System für den menschlichen Zustand bietet diesen Feedback-Loop.

Einrichtung

Option A: Zuerst verbinden, dann einen Schlüssel über Ihren Agenten erhalten (am schnellsten)

Fügen Sie die Konfiguration ohne API-Schlüssel hinzu – Ihr Agent erhält automatisch einen.

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

Fragen Sie dann Ihren Agenten:

"Verbinde dich mit Nefesh und besorge mir einen kostenlosen API-Schlüssel für name@example.com"

Der Agent ruft request_api_key auf → Sie klicken auf einen E-Mail-Link → der Agent holt den Schlüssel ab. Kein Anmeldeformular, kein manuelles Kopieren und Einfügen. Fügen Sie danach den Schlüssel für zukünftige Sitzungen zu Ihrer Konfiguration hinzu:

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

Option B: Zuerst einen Schlüssel erhalten, dann verbinden

Registrieren Sie sich unter nefesh.ai/signup (1.000 Aufrufe/Monat, keine Kreditkarte erforderlich) und fügen Sie dann die Konfiguration mit Ihrem Schlüssel hinzu:

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

Agentenspezifische Konfigurationsdateien

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

Alle Agenten verbinden sich über Streamable HTTP – keine lokale Installation erforderlich.

A2A-Integration (Agent-to-Agent Protocol v1.0)

Nefesh ist auch als A2A-kompatibler Agent verfügbar. Während MCP das Tool-Calling handhabt (Ihr Agent ruft Nefesh auf), ermöglicht A2A die Zusammenarbeit zwischen Agenten – andere KI-Agenten können als Partner mit Nefesh kommunizieren.

Agent Card: /.well-known/agent-card.json

A2A-Endpunkt: POST https://mcp.nefesh.ai/a2a (JSON-RPC 2.0)

Gleiche Authentifizierung wie bei MCP – X-Nefesh-Key-Header oder Authorization: Bearer-Token. Der kostenlose Tarif funktioniert mit beiden Protokollen.

Quelle: nefesh-ai/nefesh-a2a · Dokumentation: nefesh.ai/docs/a2a

MCP-Tools

Wie die Selbstbereitstellung funktioniert

Ihr KI-Agent kann autonom einen kostenlosen API-Schlüssel erhalten. Sie müssen nur auf einen E-Mail-Link klicken.

1. Der Agent ruft request_api_key(email) auf – für diesen Aufruf ist kein API-Schlüssel erforderlich.

2. Sie erhalten eine Bestätigungs-E-Mail und klicken auf den Link.

3. Der Agent pollt alle 10 Sekunden check_api_key_status(request_id).

4. Sobald die Verifizierung abgeschlossen ist, erhält der Agent den API-Schlüssel und kann alle anderen Tools nutzen.

Kostenloser Tarif: 1.000 Aufrufe/Monat, alle Signaltypen, 10 Anfragen/Min. Keine Kreditkarte erforderlich.

Kurzer Test

Fragen Sie nach dem Hinzufügen der Konfiguration Ihren KI-Agenten:

"Welche Tools hast du von Nefesh?"

Er sollte die 6 oben genannten Tools auflisten.

Preisgestaltung

CLI-Alternative

Bevorzugen Sie das Terminal gegenüber MCP? Nutzen Sie die Nefesh CLI (10-32x geringere Token-Kosten als MCP für KI-Agenten):

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

GitHub: nefesh-ai/nefesh-cli

Gateway-Alternative

Soll die KI automatisch adaptieren? Nutzen Sie den Nefesh Cognitive Compute Router. Ändern Sie Ihre LLM-Basis-URL auf gateway.nefesh.ai und das Gateway passt den System-Prompt und die Temperatur basierend auf dem biometrischen Zustand an. Drei Modi: OpenAI-kompatibel (/v1/chat/completions), Anthropic-Passthrough (/v1/messages) und Unified Anthropic für jedes Backend. Keine Code-Änderungen erforderlich.

GitHub: nefesh-ai/nefesh-gateway

Human State Protocol (HSP)

Nefesh implementiert und pflegt das Human State Protocol, eine offene Spezifikation für den Austausch des menschlichen physiologischen Zustands zwischen KI-Systemen. HSP definiert ein Standard-JSON-Format für Stresswerte, Verhaltensempfehlungen und Anpassungs-Feedback, sodass jeder Agent Daten zum menschlichen Zustand interoperabel erzeugen oder konsumieren kann. Apache 2.0.

GitHub: nefesh-ai/human-state-protocol · Dokumentation: nefesh.ai/docs/hsp

Dokumentation

• Vollständige API-Referenz

• Schnellstart

• Zustands-Mapping

• MCP-Server · Quelle

• A2A-Server · Quelle

• Cognitive Compute Router (Gateway) · Quelle

• CLI · Quelle

• Human State Protocol (HSP) · Quelle

• A2A Agent Card

• A2A-Protokoll-Spezifikation

Datenschutz

• Keine Video- oder Audio-Uploads – die Verarbeitung erfolgt clientseitig (Edge)

• Keine PII (personenbezogene Daten) gespeichert

• DSGVO/BIPA-konform – kaskadierende Löschung über delete_subject

• Kein medizinisches Gerät – nur für kontextbezogene KI-Anpassung

Lizenz

MIT – siehe LICENSE.