Skip to main content
Glama
LabForgeDev

copilot-memory-mcp

by LabForgeDev

copilot-memory-mcp

License: MIT

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 도구

도구

설명

create_memory

제목, 내용, 선택적 프로젝트 범위와 태그로 새 메모리를 저장합니다

search_memories

의미 기반 벡터 검색; 프로젝트 및/또는 태그로 필터링합니다

update_memory

ID로 기존 메모리를 업데이트합니다; 변경 시 재임베딩됩니다

delete_memory

ID로 메모리를 영구 삭제합니다

list_memories

페이지네이션으로 메모리를 탐색합니다(가볍고 내용은 포함하지 않음)


Copilot 지침 및 에이전트(예시)

바로 사용할 수 있는 예시는 examples/에 있습니다. 해당 파일을 자신의 프로젝트 루트 또는 .github/에 복사하세요.

파일

사용처

AGENTS.md

OpenAI Codex, Claude Code 및 대부분의 에이전트 런타임

CLAUDE.md

Claude Code(claude CLI)

.cursorrules

Cursor(레거시 형식, 프로젝트 루트)

.cursor/rules/memory-tools.mdc

Cursor(최신 규칙별 형식)

.github/copilot-instructions.md

VS Code의 GitHub Copilot

.github/prompts/save-memory.prompt.md

VS Code /save-memory 프롬프트

.github/prompts/recall-memory.prompt.md

VS Code /recall-memory 프롬프트

.github/agents/memory.md

VS Code @memory 사용자 지정 에이전트 모드


아키텍처

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

환경 변수

변수

기본값

설명

SENTENCE_TRANSFORMERS_HOME

/app/models

모델 캐시 디렉터리

CHROMA_PATH

/data/chroma

ChromaDB 영속화 경로

PORT

8000

HTTP 서버 포트

.env.example.env에 복사하고 필요하면 조정하세요.


라이선스

MIT — LICENSE 참조.

A
license - permissive license
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Local 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.
  • A
    license
    B
    quality
    B
    maintenance
    MCP 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.
    9
    91
    Apache 2.0

View all related MCP servers

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).

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/LabForgeDev/copilot-memory-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server