Copilot Memory MCP

io.github.LabForgeDev由 GitHub 帳號 LabForgeDev 發布v1.0.0更新於 Oct 24, 2026

Persistent semantic memory for AI agents using local ChromaDB vector search. No cloud required.

發布方自己的服務:Memory.fit

已驗證STDIO僅桌面資料庫知識與記憶

概覽

AI 產生的概覽

為 AI 助理提供持久、依專案區隔的語意記憶,資料存放在本機內嵌的 ChromaDB 向量資料庫中。

可以做什麼
提供五個記憶工具:create_memory 儲存含標題、內容、可選專案範圍與標籤的記憶;search_memories 進行語意向量搜尋,可依專案與標籤篩選;update_memory 依 ID 更新記憶並重新產生嵌入;delete_memory 依 ID 永久刪除記憶;list_memories 以分頁方式瀏覽記憶。記憶以 all-MiniLM-L6-v2 模型產生嵌入,存放在內嵌的 ChromaDB 集合中,因此檢索是語意比對而非關鍵字比對。
適用情境
適合讓助理在多次工作階段之間延續決策、慣例與專案脈絡,而不是每次都從空白開始。適用於需要留在本機、不依賴雲端服務的專案知識庫。
執行需求
以本機 Docker 容器方式執行(映像 ghcr.io/labforgedev/copilot-memory-mcp:1.0.0),透過 docker compose 啟動,在 8000 埠提供 HTTP/SSE 端點。嵌入模型於首次使用時下載並快取;選用環境變數 SENTENCE_TRANSFORMERS_HOME、CHROMA_PATH 與 PORT 分別調整模型快取、資料庫路徑與埠號。Docker 具名磁碟區用於保存資料庫。僅支援桌面端,未宣告驗證機制。
安裝前請注意
伺服器在本機 8000 埠暴露未驗證的 HTTP/SSE 端點,任何能連上該埠的程式都能讀取或變更已儲存的記憶。delete_memory 會永久刪除記憶,create_memory、update_memory 與 delete_memory 都會寫入持久化資料庫。記憶內容在本機產生嵌入,不會把記憶文字傳送到雲端服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Copilot Memory MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

copilot-memory-mcp

[License: MIT]

Persistent semantic memory for GitHub Copilot in VS Code.

A local MCP server that gives Copilot durable, project-scoped memory across sessions. Memories are stored in an embedded ChromaDB vector database with all-MiniLM-L6-v2 embeddings, enabling semantic retrieval (RAG). Everything runs in a single Docker container — no cloud services required.


Why this exists

Copilot starts every session with a blank slate. This MCP server gives it a persistent, searchable knowledge base so decisions, conventions, and context carry over between sessions — all running locally in Docker.


Quick start

bash
docker compose up -d

The server starts on http://localhost:8000/sse.

The .vscode/mcp.json already points Copilot at the server — no further VS Code configuration needed.

A sample config is provided in examples/vscode/mcp.json. Copy it to your project's .vscode/mcp.json.


MCP tools

ToolDescription
create_memoryStore a new memory with title, content, optional project scope and tags
search_memoriesSemantic vector search; filter by project and/or tags
update_memoryUpdate an existing memory by ID; re-embeds on change
delete_memoryPermanently delete a memory by ID
list_memoriesBrowse memories with pagination (lightweight, no content)

Copilot instructions & agents (examples)

Ready-to-use examples are in examples/. Copy the relevant file(s) into the root or .github/ of your own project.

FileConsumed by
AGENTS.mdOpenAI Codex, Claude Code, and most agent runtimes
CLAUDE.mdClaude Code (claude CLI)
.cursorrulesCursor (legacy format, project-root)
.cursor/rules/memory-tools.mdcCursor (modern per-rule format)
.github/copilot-instructions.mdGitHub Copilot in VS Code
.github/prompts/save-memory.prompt.mdVS Code /save-memory prompt
.github/prompts/recall-memory.prompt.mdVS Code /recall-memory prompt
.github/agents/memory.mdVS Code @memory custom agent mode

Architecture

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)

Project layout

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

Development

Install dependencies

bash
pip install -e ".[dev]"

Run tests

bash
pytest

Tests use an ephemeral in-memory ChromaDB and a mocked embedding function — no Docker, no model download required.

Run the server locally (no Docker)

bash
pip install -e .PYTHONPATH=. python app/main.py

Environment variables

VariableDefaultDescription
SENTENCE_TRANSFORMERS_HOME/app/modelsModel cache directory
CHROMA_PATH/data/chromaChromaDB persistence path
PORT8000HTTP server port

Copy .env.example to .env and adjust if needed.


License

MIT — see LICENSE.

來源:README.md,提交 8a1835c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Memory 整合