Skip to main content
Glama
LabForgeDev

copilot-memory-mcp

by LabForgeDev

copilot-memory-mcp

License: MIT

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 工具

工具

描述

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。

Related MCP Connectors

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
    D
    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