F
licenseNot graded
qualityD
maintenanceLocal MCP server that provides semantic search (RAG) over code repositories, enabling AI clients like Claude and Gemini to access project context without manual re-upload.
-
copilot-memory-mcp
by LabForgeDev
copilot-memory-mcp
VS Code에서 GitHub Copilot을 위한 영속적 의미 메모리입니다.
로컬 MCP 서버로, 세션을 넘어 Copilot에 프로젝트 범위의 지속적인 메모리를 제공합니다. 메모리는 all-MiniLM-L6-v2 임베딩을 사용하는 내장 ChromaDB 벡터 데이터베이스에 저장되어 의미 기반 검색(RAG)을 지원합니다. 모든 것이 단일 Docker 컨테이너에서 실행되며 클라우드 서비스가 필요 없습니다.
왜 필요한가
Copilot은 모든 세션을 빈 상태로 시작합니다. 이 MCP 서버는 Copilot에 영속적이고 검색 가능한 지식 베이스를 제공하여 결정 사항, 컨벤션, 컨텍스트가 세션 간에 이어지도록 합니다. 모든 것이 로컬 Docker에서 실행됩니다.
Related MCP server: AIVectorMemory
빠른 시작
docker compose up -d서버는 http://localhost:8000/sse에서 시작됩니다.
.vscode/mcp.json은 이미 Copilot을 서버에 연결하므로 추가적인 VS Code 설정이 필요 없습니다.
샘플 구성은 examples/vscode/mcp.json에 제공되어 있습니다. 이를 프로젝트의 .vscode/mcp.json에 복사하세요.
MCP 도구
도구 | 설명 |
| 제목, 내용, 선택적 프로젝트 범위와 태그로 새 메모리를 저장합니다 |
| 의미 기반 벡터 검색; 프로젝트 및/또는 태그로 필터링합니다 |
| ID로 기존 메모리를 업데이트합니다; 변경 시 재임베딩됩니다 |
| ID로 메모리를 영구 삭제합니다 |
| 페이지네이션으로 메모리를 탐색합니다(가볍고 내용은 포함하지 않음) |
Copilot 지침 및 에이전트(예시)
바로 사용할 수 있는 예시는 examples/에 있습니다. 해당 파일을 자신의 프로젝트 루트 또는 .github/에 복사하세요.
파일 | 사용처 |
OpenAI Codex, Claude Code 및 대부분의 에이전트 런타임 | |
Claude Code( | |
Cursor(레거시 형식, 프로젝트 루트) | |
Cursor(최신 규칙별 형식) | |
VS Code의 GitHub Copilot | |
VS Code | |
VS Code | |
VS Code |
아키텍처
VS Code / Copilot
│ MCP HTTP/SSE (port 8000)
▼
┌─────────────────────────────────┐
│ Docker Container │
│ │
│ FastMCP Server (port 8000) │
│ └── 5 MCP tools │
│ │
│ sentence-transformers │
│ └── all-MiniLM-L6-v2 │
│ (384-dim embeddings) │
│ │
│ ChromaDB (embedded) │
│ └── collection "memories" │
└──────────┬──────────────────────┘
│ Docker named volume
▼
/data/chroma (persisted DB)프로젝트 구조
copilot-memory-mcp/
├── app/
│ ├── main.py # FastMCP server, tool registration
│ ├── memory_store.py # ChromaDB wrapper (CRUD + search)
│ ├── embeddings.py # sentence-transformers loader + encode()
│ └── tools/
│ ├── create_memory.py
│ ├── search_memories.py
│ ├── update_memory.py
│ ├── delete_memory.py
│ └── list_memories.py
├── tests/
│ ├── test_memory_store.py
│ └── test_tools.py
├── Dockerfile
├── docker-compose.yml
└── pyproject.toml개발
의존성 설치
pip install -e ".[dev]"테스트 실행
pytest테스트는 임시 인메모리 ChromaDB와 모킹된 임베딩 함수를 사용하므로 Docker나 모델 다운로드가 필요 없습니다.
Docker 없이 서버를 로컬에서 실행
pip install -e .
PYTHONPATH=. python app/main.py환경 변수
변수 | 기본값 | 설명 |
|
| 모델 캐시 디렉터리 |
|
| ChromaDB 영속화 경로 |
|
| HTTP 서버 포트 |
.env.example을 .env에 복사하고 필요하면 조정하세요.
라이선스
MIT — LICENSE 참조.
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Cloud-hosted MCP server for durable AI memory
Persistent memory and cross-session learning for AI coding assistants (hosted remote MCP).
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server that provides cross-session persistent memory for AI coding assistants using local vector database and semantic search, enabling automatic recall of project context, issues, and tasks.991Apache 2.0
- FlicenseNot gradedqualityDmaintenanceA local MCP server that provides semantic memory storage and retrieval for coding and AI agents, enabling durable context across chat sessions.103 npm4-
- AlicenseAqualityDmaintenanceMCP server for semantic code indexing using vector embeddings, enabling AI agents to maintain persistent memory of codebases through natural language queries and intelligent chunking.1913 npm4MIT