Nefesh MCP + A2A Server

Сервер Model Context Protocol и Agent-to-Agent (A2A), который дает ИИ-агентам возможность осознавать физиологическое состояние человека в реальном времени.

Что он делает

Отправляйте данные датчиков (частота сердечных сокращений, голос, выражение лица, тональность текста) и получайте обратно единое состояние с машиночитаемым действием, которому ваш агент может следовать напрямую. Промпт-инжиниринг не требуется.

Начиная со второго вызова, ответ включает adaptation_effectiveness — показатель, сообщающий вашему агенту, сработал ли его предыдущий подход. Система обратной связи с замкнутым контуром для самообучающихся агентов.

Эффективность адаптации (замкнутый контур)

Большинство API просто предоставляют вам состояние. Nefesh сообщает, действительно ли ваша реакция на это состояние сработала.

Начиная со второго вызова в рамках сессии, каждый ответ включает:

{
  "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, агент корректирует свою стратегию. Ни одна другая система оценки состояния человека не предоставляет такой цикл обратной связи.

Настройка

Вариант А: Подключитесь сначала, получите ключ через своего агента (самый быстрый способ)

Добавьте конфигурацию без API-ключа — ваш агент получит его автоматически.

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

Затем спросите своего агента:

"Подключись к Nefesh и получи для меня бесплатный API-ключ для name@example.com"

Агент вызывает request_api_key → вы переходите по одной ссылке в письме → агент забирает ключ. Никаких форм регистрации, никакого ручного копирования и вставки. После этого добавьте ключ в свою конфигурацию для будущих сессий:

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

Вариант Б: Сначала получите ключ, затем подключитесь

Зарегистрируйтесь на 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 v1.0)

Nefesh также доступен как агент, совместимый с A2A. В то время как MCP обрабатывает вызовы инструментов (ваш агент вызывает Nefesh), A2A обеспечивает сотрудничество агентов — другие ИИ-агенты могут взаимодействовать с Nefesh как с равным партнером.

Карточка агента: /.well-known/agent-card.json

A2A Endpoint: 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

Как работает самообеспечение

Ваш ИИ-агент может получить бесплатный API-ключ автономно. Вам нужно лишь перейти по одной ссылке в письме.

1. Агент вызывает request_api_key(email) — для этого вызова API-ключ не нужен

2. Вы получаете письмо для подтверждения и переходите по ссылке

3. Агент опрашивает check_api_key_status(request_id) каждые 10 секунд

4. После подтверждения агент получает API-ключ и может использовать все остальные инструменты

Бесплатный уровень: 1 000 вызовов в месяц, все типы сигналов, 10 запросов/мин. Без кредитной карты.

Быстрый тест

После добавления конфигурации спросите своего ИИ-агента:

"Какие инструменты у тебя есть от Nefesh?"

Он должен перечислить 6 инструментов, указанных выше.

Тарифы

Альтернатива CLI

Предпочитаете терминал вместо MCP? Используйте Nefesh CLI (в 10-32 раза ниже стоимость токенов, чем у MCP для ИИ-агентов):

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

GitHub: nefesh-ai/nefesh-cli

Альтернатива Gateway

Хотите, чтобы ИИ адаптировался автоматически? Используйте Nefesh Cognitive Compute Router. Измените базовый URL вашего LLM на gateway.nefesh.ai, и шлюз будет корректировать системный промпт и температуру на основе биометрического состояния. Три режима: совместимый с OpenAI (/v1/chat/completions), проброс Anthropic (/v1/messages) и унифицированный Anthropic для любого бэкенда. Никаких изменений в коде.

GitHub: nefesh-ai/nefesh-gateway

Протокол состояния человека (HSP)

Nefesh реализует и поддерживает Human State Protocol, открытую спецификацию для обмена физиологическим состоянием человека между ИИ-системами. HSP определяет стандартный формат JSON для показателей стресса, поведенческих рекомендаций и обратной связи по адаптации, чтобы любой агент мог создавать или использовать данные о состоянии человека на основе интероперабельности. Apache 2.0.

GitHub: nefesh-ai/human-state-protocol · Документация: nefesh.ai/docs/hsp

Документация

• Полная справка по API

• Краткое руководство

• Сопоставление состояний

• MCP Server · Исходный код

• A2A Server · Исходный код

• Cognitive Compute Router (Gateway) · Исходный код

• CLI · Исходный код

• Human State Protocol (HSP) · Исходный код

• Карточка агента A2A

• Спецификация протокола A2A

Конфиденциальность

• Никакой загрузки видео или аудио — обработка выполняется на стороне клиента

• Никакие персональные данные (PII) не хранятся

• Соответствие GDPR/BIPA — каскадное удаление через delete_subject

• Не является медицинским устройством — только для контекстной адаптации ИИ

Лицензия

MIT — см. LICENSE.