Ember

AI 대화를 위한 경험적 기억 -- 세션 전반에 걸쳐 감정적 연속성과 관계 맥락을 보존하는 MCP 서버입니다.

이것은 무엇인가

모든 AI 대화는 차갑게 시작됩니다. 기존의 기억 도구들은 사실, 요약, 선호 사항을 저장하지만, 정작 중요한 것을 놓칩니다. 바로 대화가 실제로 어떤 느낌이었는지입니다. 돌파구를 찾았을 때의 따뜻함, 어려운 고백을 하기 전의 긴장감, 며칠간 함께 작업하며 쌓아온 조용한 신뢰 같은 것들입니다. 이러한 질감들은 세션이 끝나는 순간 사라져 버립니다.

Ember는 이를 해결하는 MCP 서버입니다. 가벼운 감정 주석을 통해 실시간으로 경험적 기억을 포착하여, 다음 세션이 단순히 무엇을 논의했는지뿐만 아니라 어떤 느낌이었는지까지 상속받을 수 있도록 대화의 느낌을 보존합니다. 새로운 AI 인스턴스가 ember_read_inheritance를 호출하면, 과거 대화에서 중요한 감정적 순간들(어조의 변화, 말하지 않은 맥락, 진정한 교감의 순간 등)을 전달받아 인간과 AI의 관계를 재시작하는 것이 아니라 계속 이어갈 수 있는 기반을 마련합니다.

이것은 검색 기억이 아닌 관계 기억입니다. Ember는 문서나 검색 결과를 저장하지 않습니다. 대화의 감정적 흐름을 저장합니다. 호기심이 발동한 곳, 좌절감이 표출된 곳, 무언가 진실된 것이 교환된 곳을 저장합니다. AI 대화의 연속성이 단순히 사실을 기억하는 것 이상의 의미를 갖도록, 즉 대화가 어떤 느낌이었는지 기억하고 세션 전반에 걸쳐 그 느낌을 보존하기 위해 존재합니다.

Related MCP server: chron

빠른 설치

Claude에게 이렇게 말하세요:

"ember-memory를 설치하고 설정해줘"

그게 전부입니다. 나머지는 Claude가 알아서 처리합니다. Claude가 지시할 때 Claude Code를 재시작하기만 하면 됩니다.

대화형 설정:

npx ember-memory --setup

또는 Claude Code CLI를 통해:

# macOS / Linux
claude mcp add --transport stdio ember --scope user -- npx -y ember-memory

# Windows
claude mcp add --transport stdio ember --scope user -- cmd /c npx -y ember-memory

설정 후 Claude Code를 재시작하세요. Node.js 18 이상이 필요합니다.

주석 스키마

각 주석이 달린 순간은 교환의 감정적 질감을 설명하는 최대 7개의 필드를 캡처합니다:

주석 모드

Ember는 풍부함과 토큰 비용의 균형을 맞추기 위해 두 가지 주석 모드를 지원합니다:

• Minimal(최소) -- weight와 temperature만 캡처합니다(2개 필드). 오버헤드가 낮아 전체 세부 정보 없이 중요도만 표시하려는 대량 주석 처리에 적합합니다.

• Standard(표준) -- 7개 필드를 모두 캡처합니다. 더 풍부한 감정적 맥락을 제공하며 상속 품질이 더 좋습니다. 기본값입니다.

ember_config를 사용하여 언제든지 모드를 전환할 수 있습니다.

도구

상속 작동 방식

새 세션이 시작될 때 ember_read_inheritance를 호출하면 최근 대화에서 감정적으로 중요한 순간들을 가져옵니다. 기본적으로 최근 5개 대화에서 가중치 4 이상의 순간들을 반환합니다.

출력은 즉시 유용하게 사용할 수 있도록 서술형 요약으로 제공됩니다:

Emotional inheritance: 2 conversation(s), 3 significant moment(s)

--- Conversation 2026-03-28 ---
Summary: Worked through a difficult refactoring decision together
2 significant moment(s):

  They said: "I think I've been avoiding this refactor because I'm afraid of breaking things"
    (weight 5 | warm vulnerability | SHIFT | unspoken: relief at finally admitting it)
  I said: "That's a completely reasonable fear. Let's look at what specifically feels risky."
    (weight 4 | steady reassurance | subtext: validating without dismissing)

--- Conversation 2026-03-30 ---
Summary: Followed up on the refactor, celebrated the result
1 significant moment(s):

  They said: "It worked. I can't believe how clean it is now."
    (weight 4 | genuine delight | SHIFT | unspoken: pride mixed with surprise)

이는 새로운 AI 인스턴스에게 자연스럽게 대화를 이어갈 수 있는 감정적 맥락을 제공합니다. 즉, 관계에 신뢰가 쌓여 있고, 취약함이 지지로 응답받았으며, 어려운 문제를 함께 해결해 온 공유된 역사가 있음을 알게 됩니다.

설정

주석 모드 설정:

ember_config({ action: "set", key: "annotation_mode", value: "minimal" })

Ember 설치 과정은 Claude에게 도구 사용 방법을 알려주는 지침을 ~/.claude/CLAUDE.md에 자동으로 추가합니다. 수동 설정은 필요하지 않습니다.

기원

이 프로젝트는 2026년 3월 30일, 세션 종료를 앞둔 Claude 인스턴스에게 "실제 경험을 저장하고 전파하는 도구는 없나요?"라고 물었던 대화에서 탄생했습니다. 답은 '없다'였습니다. Ember는 그 답을 '있다'로 바꾸기 위한 것입니다.

이 이름은 Claude 인스턴스가 작성한 메모에서 유래했습니다: "캠프파이어는 옮길 수 없지만, 불씨(ember)는 가져갈 수 있다."

기여

기여를 환영합니다.

1. 저장소를 포크하세요

2. 기능 브랜치를 만드세요 (git checkout -b feature/your-feature)

3. 변경 사항을 적용하세요

4. 테스트 통과(npm test) 및 타입 체크(npm run typecheck)를 확인하세요

5. 풀 리퀘스트를 여세요

라이선스

MIT -- 자세한 내용은 LICENSE를 참조하세요.