copilot-memory-mcp

Постоянная семантическая память для GitHub Copilot в VS Code.

Локальный MCP-сервер, который даёт Copilot постоянную память в рамках проекта между сессиями. Память хранится во встроенной векторной базе данных ChromaDB с эмбеддингами all-MiniLM-L6-v2, что обеспечивает семантический поиск (RAG). Всё работает в одном Docker-контейнере — облачные сервисы не требуются.

Зачем это нужно

Copilot начинает каждую сессию с чистого листа. Этот MCP-сервер предоставляет ему постоянную, доступную для поиска базу знаний, чтобы решения, соглашения и контекст сохранялись между сессиями — всё работает локально в 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

Инструкции и агенты Copilot (примеры)

Готовые примеры находятся в examples/. Скопируйте нужные файлы в корень или в .github/ вашего проекта.

Архитектура

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

Переменные окружения

Скопируйте .env.example в .env и при необходимости измените.

Лицензия

MIT — см. LICENSE.