Mem0 MCP 서버

AI 어시스턴트를 Mem0.ai의 지속적 메모리 시스템과 통합하기 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.

개요

이 서버는 호환되는 모든 AI 어시스턴트가 Mem0에 저장된 영구 메모리에 접근하고 관리할 수 있도록 하는 MCP 호환 도구를 제공합니다. 이 서버는 AI 모델과 Mem0 메모리 시스템을 연결하는 다리 역할을 하며, 어시스턴트가 다음과 같은 작업을 수행할 수 있도록 지원합니다.

• 기억을 저장하고 검색하세요

• 의미적 유사성이 있는 메모리 검색

• 다양한 메모리 유형(에피소드, 의미적, 절차적)을 관리합니다.

• 대화 맥락에 단기 기억을 활용하세요

• 선택적 메모리 패턴 적용

• 기억을 바탕으로 지식 그래프 만들기

Related MCP server: AGI MCP Server

프로젝트 구조

프로젝트 코드는 src/mcp_mem0_general/ 디렉토리에 있습니다.

시작하기 (설치 불필요!)

이 서버는 저장소를 복제하거나 로컬에 설치할 필요 없이 uvx 사용하여 GitHub에서 직접 실행할 수 있습니다.

서버 실행

uv 설치되어 있는지 확인하세요( pipx install uv 또는 brew install uv ).

터미널에서 직접 서버를 테스트할 수 있습니다.

지엑스피1

서버가 시작되고 초기화 단계가 기록되어야 합니다.

커서 또는 Claude Desktop 설정

1. uvx 경로 찾기: Claude Desktop과 같은 GUI 애플리케이션은 터미널과 동일한 PATH 사용하지 않는 경우가 많습니다. 터미널에서 다음 명령을 실행하여 uvx 실행 파일의 전체 경로를 찾으세요.

   which uvx

   출력 경로를 복사합니다(예: /Users/yourname/.local/bin/uvx 또는 /opt/homebrew/bin/uvx ).

2. MCP 구성: 다음 구성을 MCP 구성 파일에 추가하고, /full/path/to/uvx 1단계에서 찾은 실제 경로로 바꿉니다 .

   • 커서: ~/.cursor/mcp.json 에 추가/업데이트:

   • Claude Desktop: 설정에서 비슷한 구성을 추가/업데이트하세요.

   "mem0-memory-general": {
     "command": "/full/path/to/uvx", # <-- IMPORTANT: Use the full path from 'which uvx'
     "args": [
       "git+https://github.com/ryaker/mcp-mem0-general.git",
       "mcp-mem0-general"
     ],
     "env": {
       "MEM0_API_KEY": "your-mem0-api-key-here"
     }
   }

3. 다시 시작: 변경 사항을 적용하려면 Cursor 또는 Claude Desktop을 다시 시작하세요. 이제 서버가 애플리케이션 내에서 정상적으로 시작될 것입니다.

mem0ai[neo4j] 에 대한 참고 사항 경고

시작 중에 다음과 같은 경고가 표시될 수 있습니다 warning: The package mem0ai==0.1.96 does not have an extra named neo4j .

• 관리형 Mem0.ai 플랫폼을 사용하는 경우: 이 경고는 무시해도 됩니다. 필요한 그래프 처리는 Mem0 플랫폼의 서버 측에서 수행됩니다.

• Neo4j를 사용하여 Mem0를 셀프 호스팅하는 경우: 이 경고는 특정 mem0ai 버전이 Neo4j 관련 Python 라이브러리( langchain-neo4j , neo4j )를 자동으로 설치하지 않았음을 나타냅니다. 그래프 기능을 사용하는 경우 셀프 호스팅 환경에 이러한 라이브러리가 수동으로 설치되었는지 확인해야 합니다.

사용 가이드를 메모리에 로드(권장)

AI 비서가 서버의 기능을 쉽게 참조할 수 있도록 USAGE_GUIDE.md 콘텐츠를 Mem0에 로드할 수 있습니다. 다음 단계를 따르세요.

필수 조건: 위의 "시작하기" 섹션에 설명된 대로 AI 어시스턴트(Claude/Cursor)에서 Mem0 MCP 서버가 실행 중이고 올바르게 구성되어 있는지 확인하세요.

1. 가이드 콘텐츠 복사: USAGE_GUIDE.md 파일을 엽니다. 전체 텍스트 콘텐츠를 선택하여 복사합니다.

2. 어시스턴트에게 메모리 추가 요청: AI 어시스턴트(Claude/Cursor)로 이동하여 이와 유사한 프롬프트를 사용하여 복사한 가이드 콘텐츠를 표시된 위치에 붙여넣습니다. 일관된 user_id (예: "default_user")를 사용해야 합니다.

Mem0 MCP 서버에 대한 다음 사용 설명서를 참고하세요. user_id "default_user"를 사용하고 메타데이터 {"title": "Mem0 MCP Usage Guide", "source": "README Instruction"} 추가하세요.

[--- 여기에 USAGE_GUIDE.md 전체 내용을 붙여넣으세요 ---]

    The assistant should call the `mem0_add_memory` tool.

3.  **Find the Memory ID:** Once the assistant confirms the memory is added, ask it to find the specific ID for that memory:

    ```
Please search my memories for user_id "default_user" using the query "Mem0 MCP Usage Guide" and tell me the exact memory ID of that guide memory you just added.

The assistant should use the `mem0_search_memory` tool and provide you with an ID string (e.g., `76100ac4-896e-488b-90ad-036c0dfaaa80`). **Note down this ID!**

4. 나중에 가이드 검색: 이제 ID가 있으므로 다음과 같은 프롬프트를 사용하여 언제든지 보조자에게 전체 가이드를 빠르게 불러오도록 요청할 수 있습니다.

```
First execute Retrieve memory ID *your-guide-id-here* using mem0_get_memory_by_id. Then return control to me.
```

(Replace *`your-guide-id-here`* with the actual ID you noted down in step 3).

메모리 유형

서버는 기간과 기능에 따라 구성된 다양한 메모리 유형을 지원합니다.

단기 기억

• 대화 기억 : 최근 메시지 교환을 기억합니다.

• 작업 기억 : 적극적으로 사용되는 임시 정보

• 주의 기억 : 현재 초점이 맞춰진 정보

장기 기억

• 에피소드 기억 : 특정 사건과 경험

• 의미 기억 : 사실, 개념 및 지식

• 절차적 기억 : 기술 및 방법 정보

고급 기능

• 사용자 정의 카테고리 : 나만의 메모리 카테고리를 정의하고 관리하세요

• 메모리 지침 : 메모리를 처리하는 방법에 대한 지침을 설정합니다.

• 그래프 관계 : 엔터티 간 지식 그래프 관계에 액세스합니다.

• 선택적 메모리 : 저장하기 전에 포함/제외 패턴으로 텍스트 필터링

• 피드백 메커니즘 : 메모리 품질에 대한 피드백 제공

용법

시스템의 모든 메모리는 기본 user_id로 "default_user"를 사용합니다.

자세한 사용 예는 USAGE_GUIDE.md를 참조하세요.

선적 서류 비치

• 시작하기

• API 참조

• 메모리 유형

• 고급 기능

• 구성

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

• 뛰어난 메모리 API를 제공하는 Mem0.ai

• 서버 구현을 위한 모델 컨텍스트 프로토콜 (및 해당 Python SDK mcp )

• 이 프로젝트에 기여한 모든 사람들