Nefesh MCP + A2A 서버

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

AI 에이전트에게 실시간 인간 생리적 상태 인식 기능을 제공하는 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인 경우 에이전트는 전략을 수정합니다. 다른 어떤 인간 상태 시스템도 이러한 피드백 루프를 제공하지 않습니다.

설정

옵션 A: 먼저 연결하고 에이전트를 통해 키 받기 (가장 빠름)

API 키 없이 설정을 추가하면 에이전트가 자동으로 키를 가져옵니다.

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

그런 다음 에이전트에게 다음과 같이 요청하세요:

"Nefesh에 연결해서 name@example.com용 무료 API 키를 받아줘"

에이전트가 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	통합 페이지 (웹 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 프로토콜 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 키를 얻을 수 있습니다. 귀하는 이메일 링크만 클릭하면 됩니다.

에이전트가 request_api_key(email)를 호출합니다 (이 호출에는 API 키가 필요 없음)
귀하가 인증 이메일을 받고 링크를 클릭합니다
에이전트가 10초마다 check_api_key_status(request_id)를 폴링합니다
인증이 완료되면 에이전트가 API 키를 수신하고 다른 모든 도구를 사용할 수 있습니다

무료 티어: 월 1,000회 호출, 모든 신호 유형, 분당 10회 요청. 신용카드 불필요.

빠른 테스트

설정을 추가한 후 AI 에이전트에게 다음과 같이 물어보세요:

"Nefesh에서 사용할 수 있는 도구가 뭐야?"

위의 6가지 도구가 나열되어야 합니다.

요금

플랜	가격	API 호출
무료	$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로 변경하면 게이트웨이가 생체 상태에 따라 시스템 프롬프트와 온도를 조정합니다. 세 가지 모드: OpenAI 호환(/v1/chat/completions), Anthropic 패스스루(/v1/messages), 모든 백엔드를 위한 통합 Anthropic. 코드 변경이 전혀 필요 없습니다.

GitHub: nefesh-ai/nefesh-gateway

인간 상태 프로토콜 (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