🧠 MemoryAPI

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

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

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

기능

• 🧠 의미론적 검색 — 키워드가 아닌 의미로 메모리 찾기

• 🔌 MCP 네이티브 — Claude, Cursor, Windsurf 등에 즉시 연결

• ⚡ REST API — 간단한 HTTP 엔드포인트, 모든 언어 지원

• 🔑 API 키 인증 — 에이전트별로 안전하게 네임스페이스 지정

• 📊 사용량 추적 — 메모리 개수 및 플랜 제한 확인

• 🌍 상시 가동 — api.memoryapi.org에서 호스팅

Related MCP server: aimemory

빠른 시작

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 도구

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 키를 생성합니다.

본문:

{
  "agent_id": "my-agent",
  "email": "you@example.com",
  "plan": "free"
}

요금제

기술 스택

• 런타임: Node.js + Express

• 데이터베이스: Supabase (PostgreSQL + pgvector)

• 임베딩: OpenAI text-embedding-3-small

• 인증: bcrypt 해시 API 키

• 프로토콜: MCP 2024-11-05

라이선스

MIT © 2026 Ocean Digital Group