구조화된 JSON 또는 SQLite를 사용하여 세션 간 컨텍스트를 유지하는 AI agent용 로컬 우선 장기 기억 기능을 제공합니다.
다른 이름 LuizEduPP/Rememb
- 스타
- 5
- Tools
- —
- 다운로드, 30일
- 636
- 최신 버전
- 0.3.5
- 마지막 커밋
- 2026년 11월 2일
- 라이선스
- MIT
rememb MCP란?
rememb은(는) MCP server입니다. 구조화된 JSON 또는 SQLite를 사용하여 세션 간 컨텍스트를 유지하는 AI agent용 로컬 우선 장기 기억 기능을 제공합니다.
프로젝트 README에서 생성된 요약
rememb MCP server 정보
rememb는 서로 다른 채팅 세션 간의 컨텍스트 손실을 방지하기 위해 AI agent를 위한 로컬 우선 장기 기억 솔루션을 제공합니다. 개발자와 팀은 클라우드 서비스나 외부 API key에 의존하지 않고도 지속적인 사실, 결정 사항 및 프로젝트 아키텍처를 저장할 수 있습니다. 이 시스템은 구조화된 JSON 백엔드 또는 대규모 데이터 세트를 위한 SQLite 데이터베이스를 사용하여 로컬 머신에서 완전히 작동합니다.
사용자는 MCP 프로토콜을 사용하여 Cursor, Claude 또는 VS Code와 같은 다양한 IDE 및 agent에 이 MCP server를 통합할 수 있습니다. 설정 프로세스에는 pip를 통한 패키지 설치와 메모리 규칙 및 세션 hooks를 적용하기 위한 install 명령어 실행이 포함됩니다. rememb_write, rememb_edit, rememb_search를 포함하여 메모리 관리를 위한 18개의 특화된 도구를 제공합니다. 또한 브라우저 기반 대시보드를 통해 메모리를 감독하고 버전 히스토리를 검사하며 통계를 확인할 수 있는 로컬 웹 인터페이스를 사용할 수 있습니다.
활용 사례
- 1프로젝트 컨텍스트 유지AI agent가 기술 스택 세부 정보와 아키텍처 결정 사항을 저장하여 새로운 세션에서 반복적인 설명을 피할 수 있습니다.
- 2특정 정보 검색개발자는 키워드 및 토큰 매칭을 사용하여 관련 과거 정보를 찾도록 agent에게 지시할 수 있습니다.
- 3변경 사항 감사 및 복구메모리 항목의 히스토리를 검사하고 덮어쓰기가 잘못된 경우 이전 버전으로 되돌릴 수 있습니다.
- 4프로젝트별 메모리 관리project 인수를 사용하여 서로 다른 코드 저장소에 대해 별도의 메모리 저장소를 유지할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
rememb MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 rememb MCP 설치
$ claude mcp add rememb -- uvx remembCursor에 rememb MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"rememb": {
"command": "uvx",
"args": [
"rememb"
]
}
}
}VS Code에 rememb MCP 설치
.vscode/mcp.json
{
"servers": {
"rememb": {
"type": "stdio",
"command": "uvx",
"args": [
"rememb"
]
}
}
}VS Code CLI에 rememb MCP 설치
$ code --add-mcp '{"name":"rememb","type":"stdio","command":"uvx","args":["rememb"]}'Claude Desktop에 rememb MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"rememb": {
"command": "uvx",
"args": [
"rememb"
]
}
}
}Codex에 rememb MCP 설치
$ codex mcp add rememb -- uvx remembCodex config.toml에 rememb MCP 설치
~/.codex/config.toml
[mcp_servers.rememb] command = "uvx" args = ["rememb"]
Gemini CLI에 rememb MCP 설치
$ gemini mcp add -s user rememb uvx -- remembGemini settings.json에 rememb MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"rememb": {
"command": "uvx",
"args": [
"rememb"
]
}
}
}자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능luizedupp/rememb is public and reachablegithub.com/luizedupp/rememb ↗통과
- 패키지가 이 저장소를 소스로 명시rememb names luizedupp/rememb as sourcepypi.org/project/rememb/ ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-02github.com/luizedupp/rememb ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from rememb통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음13 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Operate AI agents without losing context between sessions. rememb is local-first long-term memory: structured entries, keyword search, versioning, diff, restore, and audit trail — no cloud, no API keys.
The problem
Teams using agents at real velocity rarely fail because they lack generation. They fail because operating agents every day creates context debt:
- too much re-explaining project facts every session
- too little durable memory outside the chat window
- too little audit trail for why something changed
- too much noise when recalling the right context
Every team or solo developer operating agents professionally hits this wall:
Session 1: "We're using PostgreSQL, auth at src/auth/, prefer async patterns."
Session 2: Agent starts from zero. You explain everything again.
Session 3: Same thing.
Existing solutions often center on hosted memory layers, API keys, or opaque context pipelines. What you actually need is to resume the next session with the minimum correct context and a trail you can inspect.
rememb is built around four memory problems:
- durable facts and decisions instead of session-only chat memory
- keyword search instead of rereading everything (agents judge relevance)
- non-destructive versioning instead of silent overwrites
- local-first audit trail for AI work, not opaque cloud logs
Install
pip install rememb
Quick Start
With MCP (recommended)
1. Install the door, or add the MCP block by hand:
rememb install --apply --project
That writes the MCP server, Memory Rules, and SessionStart / PostToolUse / Stop hooks when the host has them (Cursor and Claude today). Without --apply it only prints the plan. --host limits the target; omit it to write every host rememb install knows (cursor, claude, codex, vscode, copilot, windsurf, continue, gemini, opencode, zed, cline).
Or add this to your IDE's MCP config and paste the rules from MCP_TOOLS.md:
{
"mcpServers": {
"rememb": {
"command": "rememb",
"args": ["mcp"]
}
}
}
Add repeatable --project /path/to/repo args for per-project stores alongside global ~/.rememb. Details: MCP_TOOLS.md.
2. Restart your IDE.
SessionStart injects recent entries, tags, and a short stats block. The agent writes durable memory when something changes, and searches only when targeted recall is needed.
No extra storage setup is required. In MCP mode, rememb auto-initializes ~/.rememb and optional --project stores on first use. Public tools: MCP_TOOLS.md (18 tools).
If you want multiple MCP clients on the same machine to reuse one already-running rememb process, start a persistent local SSE transport:
rememb mcp --transport sse --host 127.0.0.1 --port 8765
This keeps one MCP process alive, so repeated clients can connect through http://127.0.0.1:8765/sse and http://127.0.0.1:8765/messages/.
Do not put --transport sse inside a stdio MCP client config. stdio clients expect JSON-RPC on stdin/stdout; the SSE mode exposes an HTTP endpoint and must be started separately.
Local usage without MCP
rememb # Open the web UI (http://localhost:18181)
rememb --port 9000 # Custom port
How it works
~/.rememb/ ← default store location (MCP and Web UI)
entries.json ← default JSON backend (or entries.db with SQLite)
meta.json ← project metadata
config.json ← limits, sections, storage backend, UI paging
A local store on disk. Your agent can read prior decisions, search by keywords and tokens, update entries without losing history, and restore previous versions without depending on a cloud memory service. Copy ~/.rememb/ anywhere to move the store.
User: "We're using PostgreSQL, auth at src/auth/, async patterns"
Agent: [rememb_write] → Saved
[New session]
SessionStart injects recent + tags + stats (handoff first)
Agent: "I see you're using PostgreSQL with auth at src/auth/..."
Writes, edits, and deletes go through rememb_write, rememb_edit, and rememb_delete. Host hooks also write into actions via rememb hook post-tool / stop. For the full MCP surface, see MCP_TOOLS.md.
Search uses keyword and token matching over entry content and tags. rememb_search returns id, score, tags, date, and a short excerpt (search_excerpt_chars, default 160). Full body is rememb_get / rememb_read on the ids the agent picked, or max_chars=0 on search. The agent applies semantic relevance judgment. No API keys, no cloud, no embedding model download at runtime.
config.json is written during initialization with all supported knobs:
{
"max_content_length": 1000000,
"max_tag_length": 500,
"max_tags_per_entry": 100,
"max_entries": 100000,
"sections": ["project", "actions", "systems", "requests", "user", "context"],
"section_colors": {
"project": "#d84848",
"actions": "#d08020",
"systems": "#d4c430",
"requests": "#40c040",
"user": "#20d4c4",
"context": "#c060f0"
},
"entry_batch_size": 24,
"entry_load_threshold": 6,
"search_excerpt_chars": 160,
"storage_backend": "json"
}
Set storage_backend to sqlite for larger stores. The Web UI and MCP migrate existing JSON entries automatically when you switch backends.
entry_batch_size and entry_load_threshold control pagination in the web UI — how many cards load at once and when to trigger "load more".
Section names are normalized to lowercase, duplicates are ignored after normalization, and removing a section with existing entries automatically migrates those entries to uncategorized. meta.json is kept in sync with the current effective section list.
Older stores may still contain legacy embedding-related config keys; they are dropped the next time configuration is loaded or saved.
Memory sections
| Section | What to store |
|---|---|
project |
Tech stack, architecture, goals |
actions |
What was done, decisions made |
systems |
Services, modules, integrations |
requests |
User preferences, recurring asks |
user |
Name, style, expertise, preferences |
context |
Anything else relevant |
Web UI
rememb includes a local web interface for supervision — browse memory, inspect history, and tune runtime settings. The SPA has no create/edit/delete controls. The HTTP API still has write, delete, and restore routes.
rememb # Open the web UI (http://localhost:18181)
rememb --host 0.0.0.0 # Bind to all interfaces
rememb --port 9000 # Custom port
rememb --no-browser # Start server without opening the browser
Overview with entry totals and recent memory activity.
Stats with totals, section breakdown, date range, and recent entries.
Settings for limits, storage backend, section colors, and maintenance actions.
Skills browser for bundled agent skills included with rememb.
Views:
- Overview — entry totals, deleted count, store size, and recent memory
- Memory — browse, keyword search, filter by section, sort, and include deleted entries
- Stats — totals, backend, section bars, oldest/newest timestamps, and recent entries
- Settings — edit limits, storage backend, section colors, consolidate duplicates, and save runtime config
- Skills — browse bundled agent skills (61 skills shipped in the package)
Entry inspection from the UI includes version history and side-by-side diff. Entry mutations and restore are MCP (rememb_write, rememb_edit, rememb_delete, rememb_restore) or the HTTP API, not SPA controls.
CLI
rememb # Open the web UI (http://localhost:18181)
rememb --host 0.0.0.0 --port 18181 --no-browser # Custom bind, no auto-open
rememb mcp # Start MCP server over stdio
rememb mcp --transport sse --host 127.0.0.1 --port 8765 # One persistent local MCP process
rememb hook session-start # Inject recent + tags + stats
rememb hook post-tool # Write a PostToolUse event from stdin
rememb hook stop # Write a Stop/handoff entry from stdin
rememb install # Show MCP + rules + hooks plan
rememb install --apply --project # Write them for the current directory
rememb --version, -v # Show version
rememb --help, -h # Show help
Compatibility
The current compatibility surface is tracked explicitly in COMPATIBILITY.md.
Short version:
- Python 3.11 to 3.14 are covered by CI
- CLI contract and MCP tool schema (18 tools) have automated test coverage
- stdio MCP is the primary documented integration path
- SSE MCP is documented and partially tested at the route level
- release automation and Trusted Publishing are documented in RELEASE.md
Design
- Local first — plain JSON or SQLite on disk
- Portable — copy
~/.rememb/anywhere, it works - Agnostic — any agent, any IDE (MCP or CLI)
- No lock-in — no servers, no API keys, no accounts
Core capabilities:
- structured memory with sections and tags
- keyword search with agent-side relevance judgment (
rememb_searchis an index: id, score, excerpt; full body via get/read) - host door: SessionStart injects recent + tags + stats; PostToolUse / Stop write into
actions; Stop tagshandoffso the next host sees it first rememb installwrites MCP, Memory Rules, and hooks (hooks for Cursor and Claude)- non-destructive versioning, diff, restore, and soft delete
- duplicate consolidation (exact content) and store stats
- config and maintenance via Web UI (settings and consolidate; entry mutations via MCP or HTTP API)
- 61 bundled agent skills via Web UI and MCP
Contributing
git clone https://github.com/LuizEduPP/Rememb
cd Rememb
pip install -e ".[dev]"
PRs welcome. Issues welcome. Stars welcome. 🌟
License
MIT
rememb MCP 질문
rememb MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add rememb -- uvx rememb를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
rememb MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
rememb를 사용하려면 인터넷 연결이나 API key가 필요한가요?
아니요, 클라우드 서비스나 API key가 필요 없는 로컬 우선 솔루션입니다.
IDE에서 rememb를 어떻게 사용하나요?
'rememb install --apply --project' 명령어를 사용하여 Cursor 및 Claude와 같은 지원되는 호스트에 MCP, Memory Rules 및 hooks를 자동으로 구성할 수 있습니다.
시각적 인터페이스를 통해 메모리 항목을 관리할 수 있나요?
네, rememb는 메모리 브라우징, 히스토리 검사 및 설정 조정을 위한 로컬 웹 UI를 포함합니다.
지원되는 저장 형식은 무엇인가요?
기본 JSON 백엔드를 지원하며, 더 큰 데이터 저장소의 경우 SQLite로 전환할 수 있습니다.