Skip to main content
Glama
LabForgeDev

copilot-memory-mcp

by LabForgeDev

copilot-memory-mcp

License: MIT

VS Code の GitHub Copilot 向けの永続的なセマンティックメモリ。

セッションをまたいで Copilot に永続的でプロジェクト単位のメモリを提供するローカル MCP サーバーです。メモリは組み込みの 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