MemOS MCP server
2026년 11월 11일 커밋AI agent가 세션 간에 정보를 저장하고 불러올 수 있도록 로컬 우선 방식의 지속 가능한 SQLite 기반 메모리 레이어를 제공합니다.
다른 이름 Markgatcha/memos
- 스타
- 10
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
MemOS MCP란?
AI agent가 세션 간에 정보를 저장하고 불러올 수 있도록 로컬 우선 방식의 지속 가능한 SQLite 기반 메모리 레이어를 제공합니다.
프로젝트 README에서 생성된 요약
MemOS MCP server 정보
MemOS는 AI agent가 서로 다른 세션에서도 지속적으로 정보를 유지할 수 있도록 설계된 로컬 우선 메모리 레이어입니다. 데이터가 클라우드 서비스나 외부 API 키 없이 사용자의 하드웨어에 저장되는 단일 SQLite 데이터베이스 파일로 작동하므로, 데이터를 직접 제어할 수 있습니다. 이 설정은 재시작 후에도 특정 세부 사항을 기억해야 하는 Claude Code, Cursor, Codex 또는 다양한 MCP 클라이언트를 사용하는 개발자에게 이상적입니다.
이 시스템은 SQLite FTS5와 임베딩을 결합한 하이브리드 검색 방식을 사용하여 관련 정보를 찾습니다. 타입 지정 그래프 엣지(typed graph edges), 시간 민감 데이터에 대한 시간적 유효성(temporal validity), 정보 출처 관리를 위한 신뢰 점수(trust scores)와 같은 고급 메모리 기능을 지원합니다. 개발자는 TypeScript SDK, CLI 또는 stdio 및 streamable HTTP를 통한 MCP server를 통해 메모리와 상호작용할 수 있습니다. 이 시스템은 이식성을 고려하여 설계되었으므로 메모리를 JSON, Markdown 또는 Obsidian 파일로 백업, 암호화 또는 내보낼 수 있습니다.
활용 사례
- 1에이전트의 장기 메모리 유지코딩 어시스턴트가 재시작 후에도 사용자의 선호도와 프로젝트 세부 정보를 기억할 수 있는 방법을 제공합니다.
- 2복잡한 정보 관계 관리그래프 기반 메모리를 사용하여 서로 다른 정보 조각들이 어떻게 연관되거나, 모순되거나, 서로를 뒷받침하는지 추적합니다.
- 3AI 도구 설정 자동화특정 개발 환경에 필요한 MCP 설정을 빠르게 구성합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능markgatcha/memos is public and reachablegithub.com/markgatcha/memos ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/markgatcha/memos ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Start here
npx -y @mem-os/sdk store "Prefers pnpm over npm" --db ./memos.db # store
npx -y @mem-os/sdk search "package manager" --db ./memos.db # recall
import { MemOS } from "@mem-os/sdk";
const memos = new MemOS(); // one SQLite file, zero config
await memos.store("Prefers pnpm over npm");
const hits = await memos.search("package manager");
Works with Claude Code · Cursor · Codex · Gemini CLI · Hermes · OpenClaw · Cline · Zed · Goose · Kilo · Ollama · LangChain · CrewAI · any MCP client. memos connect <harness> writes the config for you — see the harness matrix.
Why it is different: the memory is a single SQLite file on your disk (export it, back it up, delete it) · no network calls required · typed graph edges, temporal validity, trust scores, and provenance · MIT, no paid tier.
Reproducible retrieval
| Benchmark | Result |
|---|---|
| LongMemEval-S, full 500 | 99.4% Hit@20 · 98.3% evidence recall · 96.4% all-evidence@20 |
| ConvoMem, 387 scored | 91.0% Hit@10 · 89.4% evidence recall@10 |
| LoCoMo, full 1,986 | 65.0% Hit@10 · 59.8% evidence recall@10 |
Evidence-ID scored, no LLM judge. The LoCoMo conversations 0–1 subset (304 questions) reaches 79.8% Hit@10; the full-set number is the headline. Canonical source: website/data/benchmarks.json, generated from the raw artifacts in docs/artifacts/. Commands and caveats: benchmarks/README.md.
New here? Ingest your notes in 60 seconds — install, point at a folder, search it.
Installing? Agent-readable install contract · Harness matrix · MCP compatibility policy · per-harness snippets
Contributing? Good first issues · CONTRIBUTING.md · open benchmark leaderboard
Install
# TypeScript / Node.js
npm install @mem-os/sdk
# or run it without installing
npx -y @mem-os/sdk init --yes
# Python HTTP server
pip install mem-os-python
memos-server # http://localhost:7400
The npm package tracks tagged releases and can briefly lag main. The GitHub source is the canonical, always-current build (v1.6.27). For the latest source build, see Installation.
Connect a harness
npx -y @mem-os/sdk connect claude-code --write
npx -y @mem-os/sdk connect cursor --write
npx -y @mem-os/sdk connect codex --write
connect writes the real MCP config, keeps a backup, and prints the restart step. For every supported harness, see the harness matrix.
What you get
| Capability | What it means |
|---|---|
| One file you own | A single SQLite database; copy it, back it up, encrypt it, delete it |
| Hybrid retrieval | SQLite FTS5 + embeddings, fused and relevance-gated |
| Graph memory | Typed edges: relates_to, contradicts, supports, derived_from, temporal_precedes |
| Temporal validity | validFrom / validTo and point-in-time search |
| Trust and provenance | Source, trust score, version timeline, quarantine queue |
| Context packs | Token-budgeted memory bundles with citations |
| Consolidation | Dedupe, archive, summarize clusters, decay stale memories without losing history |
| MCP native | stdio and Streamable HTTP, with a published compatibility policy |
| Four surfaces | TypeScript SDK, CLI, MCP server, HTTP API — all on the same store |
| Adapters | OpenAI, Anthropic, Vercel, LangChain, CrewAI, Ollama |
| Portability | Import ChatGPT/Claude memory, export JSON/Markdown/Obsidian, backup/restore |
| Image memory | Captions plus optional CLIP pixel search |
Documentation
| I want to… | Read |
|---|---|
| Install in five minutes | Installation |
| Point it at my notes | Ingest your notes |
| Connect my coding agent | Harness matrix |
| Understand nodes, trust, time, packs | Memory model |
| Look up a command, tool, or route | CLI · MCP tools · HTTP API |
| Operate a store | Security model · Operations |
| See benchmark details | Results in plain English |
| Understand the architecture | ARCHITECTURE.md |
| See what is planned | ROADMAP.md |
Benchmarks
Retrieval-only, evidence-ID scored, no reader model and no LLM judge:
| Benchmark | Result |
|---|---|
| LongMemEval-S, full 500 | 99.4% Hit@20 · 96.4% all-evidence@20 |
| ConvoMem, 387 scored | 91.0% Hit@10 · 89.4% evidence recall@10 |
| LoCoMo, full 1,986 | 65.0% Hit@10 · 59.8% evidence recall@10 |
End-to-end is reported separately: 78% on a 50-question LongMemEval-S sample, self-judged with the same model. It is not comparable to vendor numbers produced with a gpt-4o judge.
The full methodology, per-category breakdowns, and the reproducible leaderboard live in Benchmark Results and benchmarks/README.md. Raw artifacts are committed under docs/artifacts/.
Part of the AI Trio
| Project | Role |
|---|---|
| universal-mcp-toolkit | MCP transport, server registry, and tool routing |
| memos | Graph-based persistent memory across sessions |
| llm-guardian | Token folding, budgets, and provider proxies |
Each project works standalone. The integrations are optional: umt link memos exposes this store as an MCP server, and Guardian can inject a MemOS context pack when MEMOS_NAMESPACE is set. Nothing here requires the other two.
Contributing
License
MIT — use it anywhere, for any purpose, no attribution required.
MemOS MCP 질문
메모리는 어떻게 저장되나요?
메모리는 로컬 디스크의 단일 SQLite 파일에 저장되므로 백업, 내보내기 또는 삭제가 간편합니다.
Claude Code나 Cursor에서 사용할 수 있나요?
네, connect 명령어를 통해 Claude Code, Cursor, Codex 등을 포함한 다양한 AI 클라이언트와 호환됩니다.