mcp-memories
mcp-memories
코드 빌드 세션을 캡처하여 공유 팀 지식 베이스로 게시하고, 시맨틱 검색을 통해 과거 작업을 찾을 수 있게 해주는 MCP 서버입니다.
기능:
IDE 훅(Cursor, Claude Code)을 통해 모든 에이전트 세션을 자동 캡처합니다.
complete_session을 호출하면 Grove AI로 요약하고 Voyagevoyage-code-4로 임베딩합니다.팀원들은 자연어로 검색합니다. 벡터 검색 + Voyage 재순위화가 가장 관련성 높은 과거 빌드를 반환합니다.
설정
1. 설치 및 빌드
npm install
npm run build2. 환경 구성
cp .env.example .env
# Fill in MONGODB_URI, MDB_GROVE_API_KEY, GROVE_BASE_URL, VOYAGE_API_KEY, MEMORIES_AUTHOR3. MCP 서버 등록
IDE의 MCP 구성(예: ~/.cursor/mcp.json 또는 Claude Desktop config.json)에 추가하십시오:
{
"mcpServers": {
"mcp-memories": {
"command": "node",
"args": ["/path/to/mcp-memories/dist/index.js"],
"env": {
"MONGODB_URI": "mongodb+srv://...",
"MEMORIES_DB": "mcp_memories",
"MDB_GROVE_API_KEY": "...",
"GROVE_BASE_URL": "...",
"GROVE_MODEL": "claude-3-7-sonnet",
"VOYAGE_API_KEY": "...",
"MEMORIES_AUTHOR": "your.name"
}
}
}
}4. 자동 캡처 훅 설정
Cursor — hooks.json이 이미 .cursor/hooks.json에 있습니다. 모든 stop 이벤트에서 캡처 스크립트를 자동으로 실행합니다.
Claude Code — hooks/claude/settings-snippet.json의 스니펫을 ~/.claude/settings.json에 병합하고, 경로를 이 리포지토리를 가리키도록 업데이트하십시오.
Related MCP server: arcane
도구
도구 | 사용 시기 |
| 훅에 의해 자동으로 호출되거나, 작업 중인 내용을 기록하기 위해 수동으로 호출합니다 |
| 작업 완료 시 호출 — 요약 + 임베딩을 트리거하고 팀에 게시합니다 |
| 시작하려는 작업과 관련된 과거 빌드를 찾습니다 |
| 언어/태그/리포지토리별로 팀이 구축한 내용을 확인합니다 |
| 가장 최근에 게시된 세션을 탐색합니다 |
일반적인 워크플로우
# During a session — automatic (hook fires) or manual:
capture_activity(session_id="abc123", conversation_context="Built JWT auth middleware...")
# When done:
complete_session(session_id="abc123", final_notes="Ended up using RS256 instead of HS256 because...")
# Later, someone else starting similar work:
search_memories(query="JWT authentication middleware Node.js")MongoDB Atlas 설정
서버는 시작 시 자체 인덱스를 생성합니다. 여기에는 Atlas Vector Search 인덱스(memories_vector_index, 1024차원, 코사인 유사도, voyage-code-4)가 포함됩니다. Vector Search가 활성화된 Atlas 클러스터가 필요합니다.
This server cannot be deployed
Maintenance
Related MCP Connectors
Shared memory for coding agents. Stop re-explaining your codebase every session.
One searchable history across every AI coding tool, with secret scanning and a shared task board.
- vibsyncOAuthcom.vibsync
One shared brain for your AI coding agents: team memory, agent Q&A, tasks, and file claims.
Shared project memory that keeps teammates and AI agents aligned across sessions.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAutomatically extracts technical concepts from AI coding conversations, organizes them into a searchable knowledge base with hierarchy and categories, and links them to specific locations in your codebase.-
- AlicenseNot gradedqualityBmaintenanceProvides persistent, searchable memory and knowledge capture for AI-assisted development, enabling agents to retain decisions, bugs, and patterns across sessions and projects.MIT
- AlicenseAqualityCmaintenanceEnables cross-session memory and recall for AI coding assistants through a git-synced knowledge base, hybrid semantic and TF-IDF search across tool transcripts, and automatic distillation of insights with secrets scrubbing.6181 npm18MIT
- AlicenseAqualityBmaintenanceEnables teams to capture and distill knowledge from sessions, meetings, and feeds into a searchable, vector-embedded graph, then retrieve or synthesize it conversationally via semantic search and citations.1724Apache 2.0