🧠 MemoryAPI

AI 에이전트 및 LLM을 위한 영구 메모리 — REST API + MCP 네이티브

License: MIT MCP Compatible

MemoryAPI는 AI 에이전트가 세션 전반에 걸쳐 지속적이고 검색 가능한 메모리를 가질 수 있도록 합니다. 자연어로 메모리를 저장하고 의미론적으로 검색하세요. 정확한 키워드는 필요하지 않습니다.

🌐 memoryapi.org | 📡 API: api.memoryapi.org

기능

🧠 의미론적 검색 — 키워드가 아닌 의미로 메모리 찾기
🔌 MCP 네이티브 — Claude, Cursor, Windsurf 등에 즉시 연결
⚡ REST API — 간단한 HTTP 엔드포인트, 모든 언어 지원
🔑 API 키 인증 — 에이전트별로 안전하게 네임스페이스 지정
📊 사용량 추적 — 메모리 개수 및 플랜 제한 확인
🌍 상시 가동 — api.memoryapi.org에서 호스팅

빠른 시작

1. API 키 발급받기

curl -X POST https://api.memoryapi.org/keys \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "my-agent", "email": "you@example.com"}'

반환값:

{
  "api_key": "mem_xxxxxxxx.yyyyyyyy",
  "message": "Save this key securely — it will not be shown again."
}

2. 메모리 저장하기

curl -X POST https://api.memoryapi.org/memory \
  -H "Content-Type: application/json" \
  -H "x-api-key: mem_xxxxxxxx.yyyyyyyy" \
  -d '{"content": "User prefers dark mode and React Native"}'

3. 메모리 검색하기

curl "https://api.memoryapi.org/memory?query=what+does+the+user+prefer" \
  -H "x-api-key: mem_xxxxxxxx.yyyyyyyy"

MCP 통합

MCP 클라이언트 설정(Claude Desktop, Cursor, Windsurf 등)에 추가하세요:

{
  "mcpServers": {
    "memoryapi": {
      "url": "https://api.memoryapi.org/mcp",
      "headers": {
        "x-api-key": "mem_xxxxxxxx.yyyyyyyy"
      }
    }
  }
}

사용 가능한 MCP 도구

도구	설명
`store_memory`	자연어로 메모리 저장
`search_memory`	메모리를 의미론적으로 검색
`list_memories`	저장된 모든 메모리 나열
`delete_memory`	ID로 메모리 삭제

REST API 참조

`POST /memory`

메모리를 저장합니다.

헤더: x-api-key: your-key

본문:

{
  "content": "string (required, max 10,000 chars)",
  "metadata": { "type": "preference" }
}

`GET /memory?query=...`

메모리 전반에 걸쳐 의미론적 검색을 수행합니다.

헤더: x-api-key: your-key

쿼리 매개변수:

query (필수) — 자연어 검색어
limit (선택 사항, 기본값 10) — 최대 결과 수
threshold (선택 사항, 기본값 0.4) — 유사도 임계값

`GET /memory/list`

에이전트의 모든 메모리를 나열합니다.

쿼리 매개변수:

limit (기본값 50)
offset (기본값 0)

`DELETE /memory/:id`

특정 메모리를 삭제합니다.

`POST /keys`

새 API 키를 생성합니다.