Nefesh

Nefesh MCP + A2A 服务

一个 Model Context Protocol 和 Agent-to-Agent (A2A) 服务，让 AI Agent 能够实时感知人类的生理状态。

功能介绍

发送传感器数据（心率、语音、面部表情、文本情感），即可获得统一状态，以及 Agent 可直接执行的机器可读操作。无需进行提示词工程。

在第 2 次及之后的调用中，响应会包含 adaptation_effectiveness，告知 Agent 之前采取的方法是否有效。这是一个让 Agent 自我改进的闭环反馈系统。

适应效果（闭环）

大多数 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
  }
}

你的 Agent 可以读取 effective: true，确认之前的降级措施有效。如果 effective: false，Agent 就会调整策略。其他人类状态系统都不提供这种反馈闭环。

设置

选项 A：先连接，通过 Agent 获取密钥（最快）

添加配置，不填写 API 密钥——Agent 会自动获取密钥。

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

然后向 Agent 提问：

“使用我的电子邮件地址为我获取一个免费的 Nefesh API 密钥”

Agent 会调用 request_api_key → 你点击一封电子邮件中的链接 → Agent 获取密钥。无需填写注册表单，也无需手动复制粘贴。之后，将密钥添加到配置中，以便在后续会话中使用：

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

各 Agent 对应的配置文件

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

所有 Agent 均通过 Streamable HTTP 连接——无需本地安装。

A2A 集成（Agent-to-Agent Protocol v1.0）

Nefesh 也可作为兼容 A2A 的 Agent 使用。MCP 负责工具调用（你的 Agent 调用 Nefesh），而 A2A 支持 Agent 间协作——其他 AI Agent 可以将 Nefesh 视为同级伙伴并与之通信。

Agent 卡片： /.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 Agent 可以自主获取免费 API 密钥。你只需点击一封邮件中的链接。

1. Agent 会询问你：“你的邮箱地址是什么？”
2. Agent 调用 request_api_key(your_real_email)。此调用不需要 API 密钥。
3. 你会收到一封验证邮件，并点击其中的链接
4. Agent 每隔 10 秒调用一次 check_api_key_status(your_real_email) 进行轮询
5. 验证完成后，Agent 会收到 API 密钥，并可使用所有其他工具

重要： Agent 必须使用你真实且可访问的邮箱地址。一次性邮箱会被屏蔽。必须由你点击验证链接才能激活密钥。

免费套餐：每月 1,000 次调用，支持所有信号类型，每分钟 10 个请求。无需信用卡。

快速测试

添加配置后，询问你的 AI Agent：

“你有哪些来自 Nefesh 的工具？”

它应该会列出上面的 6 个工具。

定价

CLI 替代方案

相比 MCP，你更喜欢使用终端？使用 Nefesh CLI（对于 AI Agent，令牌成本比 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，网关便会根据生物特征状态调整系统提示词和温度。支持三种模式：兼容 OpenAI（/v1/chat/completions）、Anthropic 直通（/v1/messages）以及适用于任意后端的 Unified Anthropic。无需修改代码。

GitHub：nefesh-ai/nefesh-gateway

人体状态协议（HSP）

Nefesh 实现并维护人体状态协议，这是一项开放规范，用于在 AI 系统之间交换人体生理状态。HSP 定义了标准 JSON 格式，用于表示压力评分、行为建议和适应反馈，让任何 Agent 都能以互操作的方式生成或使用人体状态数据。Apache 2.0。

GitHub：nefesh-ai/human-state-protocol · 文档：nefesh.ai/docs/hsp

文档

• 完整 API 参考
• 快速入门
• 状态映射
• MCP 服务 · 源代码
• A2A 服务 · 源代码
• 认知计算路由器（网关） · 源代码
• 命令行工具 · 源代码
• 人体状态协议（HSP） · 源代码
• A2A Agent 卡片
• A2A 协议规范

隐私

• 不上传视频或音频——边缘处理在客户端运行
• 不存储个人身份信息（PII）
• 符合 GDPR/BIPA 规定——通过 delete_subject 级联删除
• 非医疗器械——仅用于情境化 AI 适配

许可证

MIT——参见 LICENSE。