Nefesh MCP + A2A 服务器

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

这是一个 Model Context Protocol 和 Agent-to-Agent (A2A) 服务器，旨在为 AI 智能体提供人类生理状态的实时感知。

功能概述

发送传感器数据（心率、语音、面部表情、文本情感），即可获得包含机器可读操作建议的统一状态，智能体可直接执行。无需任何提示词工程。

在第二次及后续调用中，响应包含 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 并确认其之前的降压措施有效。如果为 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 Server
Zed	`~/.config/zed/settings.json` (使用 `context_servers`)
OpenAI Codex CLI	`~/.codex/config.toml`
Goose CLI	`~/.config/goose/config.yaml`
ChatGPT Desktop	设置 > 应用 > 添加 MCP Server (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

所有智能体均通过流式 HTTP 连接 — 无需本地安装。

A2A 集成 (Agent-to-Agent 协议 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` 或 `ready`（包含 API 密钥）。
`get_human_state`	是	获取压力状态 (0-100)、`suggested_action`（维持/简化/降压/暂停）以及 `adaptation_effectiveness` — 一个闭环反馈，显示你之前的操作是否减轻了压力。
`ingest`	是	发送生物特征信号（心率、HRV、语音语调、表情、情感，30+ 字段）并获取统一状态。包含 `subject_id` 以记录触发记忆。
`get_trigger_memory`	是	获取心理触发因素概况 — 哪些话题导致压力（活跃）以及哪些已随时间解决。
`get_session_history`	是	获取带趋势（上升/下降/稳定）的时间戳状态历史记录。

自助配置的工作原理

你的 AI 智能体可以自主获取免费 API 密钥。你只需点击一封电子邮件链接。

智能体调用 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 调用
免费	$0	每月 1,000 次，无需信用卡
个人	$25/月	每月 50,000 次
企业	定制	定制 SLA

CLI 替代方案

比起 MCP 更喜欢终端？使用 Nefesh CLI（对于 AI 智能体，Token 成本比 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) 以及适用于任何后端的统一 Anthropic 模式。无需更改代码。

GitHub: nefesh-ai/nefesh-gateway

人类状态协议 (HSP)

Nefesh 实现并维护 Human State Protocol，这是一个用于在 AI 系统间交换人类生理状态的开放规范。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