Memcord MCP server
Saves, searches, and summarizes chat history in local memory slots so AI clients keep context across sessions.
다른 이름 ukkit/memcord
- 스타
- 74
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 8월 7일
- 라이선스
- MIT
Memcord MCP란?
Memcord은(는) MCP server입니다. Saves, searches, and summarizes chat history in local memory slots so AI clients keep context across sessions.
프로젝트 README에서 생성된 요약
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능ukkit/memcord is public and reachablegithub.com/ukkit/memcord ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-08-07github.com/ukkit/memcord ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기What's new in v4.3.6 — removes two unnecessary dependencies (
pandas,python-magic) from a fresh install; CSV/TSV import now uses the standard library instead of pandas.
Table of Contents
- Core Benefits
- Prerequisites
- Quick Start
- Keeping Memcord Updated
- Using Memcord
- Custom Storage Path
- Summarizer Backends
- IDE Configuration
- Documentation
Core Benefits
- Infinite Memory - Claude remembers everything across unlimited conversations with intelligent auto-summarization
- Your Data, Your Control - 100% local storage with zero cloud dependencies or privacy concerns
- Effortless Organization - Per-project memory slots with timeline navigation and smart tagging
- Intelligent Merging - Automatically combines related conversations while eliminating duplicates
Prerequisites
-
Python 3.10+ — python.org
-
uv (Python package manager) — install with:
macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Quick Start
macOS / Linux:
curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash
Windows (PowerShell):
irm https://github.com/ukkit/memcord/raw/main/install.ps1 | iex
This will:
- ✅ Download and setup memcord
- ✅ Set up Python virtual environment using uv
- ✅ Generate platform-specific MCP configuration files
- ✅ Configure Claude Desktop, Claude Code, VSCode, and Antigravity IDE
Keeping Memcord Updated
Re-run the same installer command from Quick Start from the same folder where memcord is installed — it detects an existing installation and updates it in place instead of cloning a fresh copy:
macOS / Linux:
curl -fsSL https://github.com/ukkit/memcord/raw/main/install.sh | bash
Windows (PowerShell):
irm https://github.com/ukkit/memcord/raw/main/install.ps1 | iex
This will:
- ✅ Pull the latest changes (fast-forward only — aborts safely if you have local edits)
- ✅ Reuse your existing virtual environment and upgrade dependencies
- ✅ Regenerate MCP configuration files
- ✅ Leave your memory data (
memory_slots/) and generated configs untouched
cd /path/to/memcord
git pull
uv pip install -e . --upgrade
uv run python scripts/generate-config.py # Regenerate configs
# Optional: Enable auto-save hooks (new in v2.5.0)
uv run python scripts/generate-config.py --install-hooks
The --install-hooks flag is idempotent — it merges into existing .claude/settings.json without overwriting other settings or hooks.
Switching an Existing Install to Global Scope
Fresh installs register memcord globally (~/.claude.json) by default — available in every project. If you have an older install that's still project-scoped (a local .mcp.json), switch it explicitly — re-running the updater alone won't do this for you, since it auto-detects and preserves an existing project-scoped setup on purpose:
cd /path/to/memcord
uv run python scripts/generate-config.py --scope user
Verify from a different project directory: claude mcp list should now show memcord. The original .mcp.json is left in place and still works (harmless, just redundant) — delete it only if you want that directory to stop pinning its own local copy instead of falling through to the global one.
Installing Slash Commands Globally
The 17 memcord-* slash commands ship in .claude/commands/ and are already usable from inside the memcord checkout the moment you clone it. To use them from any project directory, install them globally into ~/.claude/commands/:
uv run python scripts/generate-config.py --manage-commands # interactive picker
uv run python scripts/generate-config.py --commands all # non-interactive: install all
Fresh installs prompt for this automatically (skipped when non-interactive, e.g. curl | bash). Re-run anytime to change your selection — only memcord's own command files are ever added or removed.
Using Memcord
First-Time Setup (New Project)
# 1. Once you are in claude code, initialize the project with a memory slot (one-time setup)
memcord_init "." "my-project-name"
# OR
memcord_init "my_project_name"
# Creates .memcord file containing "my-project-name"
# 2. Start saving your conversations
/memcord-save-progress # Auto-detects slot from .memcord file
Subsequent Sessions (Returning to Project)
# Just use slash commands - no slot name needed!
/memcord-read # Reads from bound slot
/memcord-save # Saves to bound slot
/memcord-save-progress # Summarizes and saves
Searching & Querying (Direct Tool Calls)
memcord_select_entry "2 hours ago" # Jump to a point in the timeline
memcord_list # List all slots
memcord_search "API design" # Full-text search
memcord_query "What did we decide?" # Natural language query
See Complete Tools Reference for all 23 tools with full parameters and examples.
How Auto-Detection Works
All read and write operations follow the same slot resolution priority:
- Explicit
slot_nameargument (always wins) - Currently active slot (set by
memcord_useormemcord_name) .memcordbinding file in the current working directory
When the .memcord binding is used and the slot already exists, it is also auto-activated for the rest of the session — so subsequent operations skip re-detection automatically.
This means after memcord_init, a fresh session (no memcord_use call needed) will correctly route memcord_save, memcord_save_progress, memcord_configure, and memcord_read to the bound slot.
Custom Storage Path
Point a slot's data file at any directory — e.g. a Dropbox/OneDrive folder — to share it across devices, via memcord_configure. Once linked, the slot's settings (summarizer backend, etc.) travel with the data too, so every device sharing the folder sees the same configuration.
New memory in an external path:
memcord_name "shared_slot"
memcord_configure action="set" key="custom_storage_path" value="D:\Dropbox\shared"
memcord_save "..." # writes directly to the external path
Migrate an existing memory:
memcord_configure action="set" key="custom_storage_path" value="D:\Dropbox\shared"
# Existing data is moved automatically — memcord_read/memcord_list keep working
Each device needs to run the set command once with its own local path to the shared folder. See Tools Reference — memcord_configure for migration/collision details.
Summarizer Backends
Memcord supports four pluggable summarizer backends (nltk, sumy, semantic, transformers), switchable per slot via memcord_configure action="set" key="summarizer_backend" value="..." — no restart required. New slots default to sumy (no downloads); existing slots keep nltk for backward compatibility.
See Tools Reference — memcord_configure and Features Guide for the full backend comparison, install instructions, and the MEMCORD_SUMMARIZER env var override.
IDE Configuration
The installer auto-configures all supported IDEs. For manual setup or troubleshooting, see the detailed guides:
| IDE / Client | Guide |
|---|---|
| Claude Code CLI | Installation Guide — Claude Code |
| Claude Desktop | Installation Guide — Claude Desktop |
| VSCode + GitHub Copilot | VSCode Setup Guide |
| Google Antigravity | Installation Guide — Other MCP Apps |
| Configuration templates | config-templates/ (README) |
Manual Installation
git clone https://github.com/ukkit/memcord.git
cd memcord
uv venv && uv pip install -e .
uv run python scripts/generate-config.py
See the Complete Installation Guide for updating, advanced options, and custom commands.
Documentation
| Guide | Description |
|---|---|
| Installation Guide | Complete setup instructions for all MCP applications |
| Feature Guide | Complete list of features |
| Tools Reference | Detailed documentation for all 23 tools |
| Import & Merge Guide | Comprehensive guide for Phase 3 features |
| Search & Query Guide | Advanced search features and natural language queries |
| Usage Examples | Real-world workflows and practical use cases |
| Data Format Specification | Technical details and file formats |
| Troubleshooting | Common issues and solutions |
| Version History | Changelog for all releases |
If you find this project helpful, consider:
- ⭐ Starring the repository on GitHub
- ☕ Support Development
- 🐛 Reporting bugs and suggesting features
MIT License - see LICENSE file for details.
Memcord MCP 질문
Does Memcord store my chat data in the cloud?
No. Memcord keeps everything in 100% local storage with no cloud dependencies, so your chat history stays on your machine.
How do I search past conversations with Memcord?
Use the memcord_search tool for full-text search or memcord_query for natural language questions across your saved chats.
Can Memcord summarize long conversations automatically?
Yes. It supports four pluggable summarizer backends (nltk, sumy, semantic, transformers) that can be switched per slot without restarting.
Which IDEs and clients can I use Memcord with?
The installer configures Claude Desktop, Claude Code, VSCode with GitHub Copilot, and Google Antigravity.
Can I store a Memcord slot outside the default folder?
Yes. Set the custom_storage_path key via memcord_configure to point a slot at any directory, such as a Dropbox or OneDrive folder.