@mnemoverse/mcp-memory-server

AI 에이전트를 위한 호스팅 메모리로, 어떤 사실이 중요한지 스스로 학습합니다. 피드백이 회상 순위를 재조정합니다 — 유사도 점수가 아니라 예측 오차에 대한 Rescorla-Wagner 업데이트 방식이므로, 도움이 된 것은 올라가고 오해를 불러일으킨 것은 내려갑니다. 또한 회상은 최근 메모리를 선호합니다(약 30일 반감기를 가진 지수적 최신성 부스트). 엔진에는 통합(consolidation) 기능도 포함되어 있습니다(HDBSCAN 클러스터링, Von Restorff 보호로 독특한 기억이 압축 과정에서 살아남음). 하나의 API 키로 Claude, Cursor, VS Code, ChatGPT 및 모든 MCP 클라이언트에서 사용할 수 있습니다.

세션, 프로젝트, 도구를 넘어 지속되는 메모리 — 그리고 사용할수록 개선됩니다. 호스팅 방식이라 인프라를 운영할 필요가 없고, 특정 클라우드에 종속되지 않습니다.

⭐ Mnemoverse가 에이전트에게 컨텍스트를 다시 설명하는 수고를 덜어준다면, 저장소에 스타를 남겨주세요. 다른 빌더들이 이 프로젝트를 찾는 데 도움이 됩니다.

빠른 시작

1. 무료 API 키 받기

console.mnemoverse.com에서 가입하세요 — 30초면 충분하며, 신용카드는 필요 없습니다.

2. AI 도구에 연결하기

Claude Code — CLI로 추가:

claude mcp add mnemoverse -s user \
  -e MNEMOVERSE_API_KEY=mk_live_YOUR_KEY \
  -e MNEMOVERSE_API_URL=https://core.mnemoverse.com/api/v1 \
  -- npx -y @mnemoverse/mcp-memory-server@latest

Cursor — 클릭하여 설치하거나 .cursor/mcp.json에 추가:

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

VS Code — .vscode/mcp.json에 추가 (참고: VS Code는 mcpServers가 아닌 servers를 사용합니다):

{
  "servers": {
    "mnemoverse": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json에 추가:

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

기타 MCP 클라이언트 — 동일한 서버, 다른 설정 파일:

Zed — ~/.config/zed/settings.json에 추가 (Zed는 context_servers를 사용하며, "source": "custom"이 필수입니다):

{
  "context_servers": {
    "mnemoverse": {
      "source": "custom",
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

JetBrains (AI Assistant) — *Settings → Tools → AI Assistant → Model Context Protocol (MCP)*로 이동한 후 붙여넣기:

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

Cline — MCP Servers → Configure (또는 cline_mcp_settings.json 편집). Cline은 env 값을 문자 그대로 읽으므로 ${VAR} 참조가 아닌 실제 키를 붙여넣으세요:

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

Continue — ~/.continue/mcpServers/mnemoverse.yaml 추가 (Continue는 YAML 사용):

mcpServers:
  - name: mnemoverse
    command: npx
    args:
      - "-y"
      - "@mnemoverse/mcp-memory-server@latest"
    env:
      MNEMOVERSE_API_KEY: "mk_live_YOUR_KEY"
      MNEMOVERSE_API_URL: "https://core.mnemoverse.com/api/v1"

왜 @latest인가? npx @mnemoverse/mcp-memory-server는 npm에 의해 무기한 캐시되어 레지스트리 재확인을 중단합니다. @latest 접미사는 모든 Claude Code / Cursor / VS Code 세션 시작 시 메타데이터 조회를 강제하므로(약 100-300ms), 항상 새 릴리스를 받을 수 있습니다.

⚠️ 설정을 편집한 후 AI 클라이언트를 재시작하세요. MCP 서버는 클라이언트 시작 시에만 로드됩니다.

3. 사용해 보기 — 30초면 작동 확인 가능

AI 채팅에 다음을 붙여넣으세요:

"제가 가장 좋아하는 TypeScript 프레임워크는 Hono라는 것을 기억해 주세요. 그리고 memory_write를 호출해서 저장해 주세요."

에이전트가 memory_write를 호출하고 메모리가 저장되었음을 확인해야 합니다.

그런 다음 새 채팅 / 새 세션을 열고(이것이 핵심입니다 — 메모리는 재시작 후에도 유지됩니다) 다음과 같이 물어보세요:

"제가 가장 좋아하는 TypeScript 프레임워크는 무엇인가요?"

에이전트가 memory_read를 호출하고 항목을 찾아 "Hono"라고 답해야 합니다. 그렇다면 연결이 완료된 것입니다. 이제 원하는 것을 자유롭게 저장하세요.

기억하지 못한다면: 클라이언트가 완전히 재시작되었는지, 설정에 실제 mk_live_... 키가 있고 자리 표시자가 아닌지 확인하세요.

Related MCP server: memmd-mcp

도구

아이디어: 무엇을 기억할까

• 사용자 선호도: "다크 모드를 사용합니다", "CSS 모듈보다 Tailwind를 선호합니다"

• 프로젝트 컨텍스트: "이 프로젝트는 PostgreSQL + Prisma를 사용합니다", "Railway에 배포"

• 교훈: "이 저장소에서는 푸시 전에 항상 테스트를 실행하세요"

• 결정 사항: "캐싱 단순성 때문에 REST보다 GraphQL을 선택했습니다"

• 사람과 역할: "Alice는 디자이너이고, Bob은 API를 담당합니다"

• 과거 실수: "금요일에는 배포하지 마세요 — 뼈저리게 배웠습니다"

범용 메모리

동일한 API 키가 모든 도구에서 작동합니다. Claude Code에서 메모리를 작성하고 Cursor에서 읽으세요. VS Code에서 배운 것을 GPT Custom Action도 알 수 있습니다.

                    ┌── Claude Code (this MCP server)
                    ├── Cursor (this MCP server)
   Mnemoverse API ──├── VS Code (this MCP server)
   (one memory)     ├── GPT (Custom Actions)
                    ├── Python SDK (pip install mnemoverse)
                    └── REST API (curl)

구성

링크

설정 및 참조

• 문서

• Cursor · VS Code · Claude Code · ChatGPT

• Python SDK

• API 참조

• 콘솔 (API 키 받기)

배경 자료

• 메모리 MCP 서버 비교 — 가격 및 레지스트리 등록 여부를 포함한 13가지 운영 옵션

• 메모리 MCP 서버 선택 방법 — 후보를 좁히는 다섯 가지 질문

• AI 에이전트 메모리란 무엇인가 — 카테고리 설명

• 이것은 벡터 데이터베이스인가? — 메모리 레이어를 다르게 만드는 요소

• 멀티 에이전트 시스템을 위한 공유 메모리 — Rooms 작동 방식과 사용 시기

프로젝트

• GitHub

• 릴리스

• MCP 레지스트리 항목

• 기여하기

개인정보 보호 정책

이 서버는 API 키로 인증된 Mnemoverse API(core.mnemoverse.com)에 도구 호출이 전달하는 데이터만 전송하며, 그 외에 볼 수 있는 것은 전송하지 않습니다. AI 클라이언트의 대화 기록, 로컬 파일, 또는 memory_* / vault_* 도구에 전달하지 않은 어떤 것도 읽지 않습니다. 저장된 메모리는 사용자 계정 아래에 있으며, Mnemoverse는 이를 판매하지 않으며 자체적으로 공유하지 않습니다. 유일한 공유 경로는 사용자가 직접 만드는 것입니다: 누군가를 공유 룸에 초대하면 그들의 어시스턴트가 해당 룸의 메모리에 접근할 수 있으며, 초대 범위에 의해 제한됩니다.

각 도구가 전송하는 데이터:

명시적으로 요청하지 않은 한 가지가 전송됩니다: 0.8.1부터 검색이나 피드가 비어 있을 때, 서버는 빈 응답이 무엇을 다루지 않았는지 설명할 수 있도록 인증된 읽기 전용 GET 프로브(/memory/rooms 및/또는 /memory/stats)를 한두 개 전송합니다. 프로브는 API 키 외에는 아무것도 전달하지 않으며, 저장된 상태를 변경하지 않고, CHANGELOG에 공개되어 있습니다.

라이선스

MIT © Mnemoverse