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 集成