Skip to content
Heinrich Krupp edited this page Nov 5, 2026 · 39 revisions

MCP Memory Service

Persistent semantic memory for AI agents and coding assistants.

MCP Memory Service is a production-ready memory layer accessible via MCP protocol, REST API, and HTTP transport. Store, retrieve, and consolidate memories with local vector search — no cloud lock-in required.

v12.6.0 (2026-11-05) · Python 3.11+ · GitHub · PyPI · Apache-2.0 License

In the media: Agents Overdrawn at the Memory Bank — Heavybit's Humans in the Loop interviews maintainer Heinrich Krupp on agent amnesia and why persistent memory is the missing infrastructure layer.

"Your project has inspired me in many ways. In my view, it's the best implementation of MCP memory I've found so far." — Michał Zubkowicz


Quick Start

# Python 3.11 or newer
pip install mcp-memory-service

# Start HTTP server (dashboard + REST API)
MCP_ALLOW_ANONYMOUS_ACCESS=true memory server --http

# Or start MCP server (for Claude Desktop / IDE integrations)
memory server

The anonymous HTTP example is for local use. For shared deployments, configure authentication and HTTPS.

Dashboard: http://127.0.0.1:8000

Detailed setup: Installation Guide · Platform Setup


What It Does

Capability Details
Semantic search Local ONNX embeddings (all-MiniLM-L6-v2), no API key needed
MCP + REST Unified MCP tools · full REST API · SSE real-time updates
Multiple backends SQLite-vec (local) · Hybrid (local + Cloudflare sync) · Milvus · Cloudflare
Memory lifecycle Store → consolidate → quality-score → forget (dream-inspired)
Graph relations Associate memories, infer relationship types, query subgraphs
Plugin system Lifecycle hooks: on_store, on_retrieve, on_delete, on_consolidate
14+ integrations Claude Desktop · Claude Code · OpenCode · LangGraph · CrewAI · AutoGen · VS Code · Cursor · and more
OAuth 2.1 Dynamic Client Registration (RFC 7591) · PKCE · team collaboration

Connect to Your Client

Claude Desktop

Edit the Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "memory": {
      "command": "memory",
      "args": ["server"]
    }
  }
}

Claude Code / OpenCode

# Local HTTP service for OpenCode or REST clients
MCP_ALLOW_ANONYMOUS_ACCESS=true memory server --http

# Claude Code over stdio
claude mcp add memory -- memory server

# OpenCode requires the repository plugin; see the Integration Guide below.

→ Integration Guide · Claude.ai Remote MCP

REST API

# Store
curl -X POST http://127.0.0.1:8000/api/memories \
  -H "Content-Type: application/json" \
  -d '{"content": "JWT tokens expire after 24h", "tags": ["auth"]}'

# Search
curl -X POST http://127.0.0.1:8000/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "authentication tokens", "limit": 5}'

Storage Backends

Backend Best For Read Speed
SQLite-vec Local / single-user ~5ms
Hybrid Production (local reads + Cloudflare sync) ~5ms
Cloudflare Cloud-only / edge deployment network
Milvus Large-scale / distributed ~5ms
# After configuring the Cloudflare credentials described in Hybrid Setup
export MCP_MEMORY_STORAGE_BACKEND=hybrid
MCP_ALLOW_ANONYMOUS_ACCESS=true memory server --http

→ Advanced Configuration · Hybrid Setup


Documentation

Core Guides

Guide Description
Installation Guide All platforms, all backends
Platform Setup Windows, macOS, Linux
Integration Guide Claude Desktop, Claude Code, VS Code, 14+ clients
Claude.ai Remote MCP HTTPS + OAuth for remote access
Web Dashboard Guide Search, analytics, bulk operations
Advanced Configuration Env vars, WAL mode, concurrent access
OAuth 2.1 Setup Dynamic registration, PKCE, team auth

Features & Subsystems

Guide Description
Token-Efficient Retrieval Bounding oversized search responses, and the memory_explore → memory_detail knowledge map
Memory Quality System ONNX local scoring, Groq/Gemini tiers
Memory Consolidation Dream-inspired decay, compression, forgetting
Graph Database Architecture Associations, relationship inference, subgraph queries
Memory Hooks Plugin lifecycle hooks
ONNX Quality Evaluation Local ML ranking without cloud calls
Dashboard UI Guide Web interface walkthrough

Reference

Resource Description
Troubleshooting Common issues, backend diagnostics, lock errors
FAQ Frequently asked questions
Examples Code examples and workflows
Development Reference API reference, hooks, debugging
Performance Optimization Query tuning, caching, scaling
Development Roadmap Upcoming features and milestones
Architecture Diagram Interactive Archify diagram of the runtime architecture, as embedded in a local Hermes agent
Deployment Landscape GitHub Actions, GitLab mirror, PyPI, Docker Hub and Cloudflare Pages

All Wiki Pages

Setup & Backends

Features

Community & Governance


Architecture

┌─────────────────────────┐    ┌──────────────────────────┐    ┌─────────────────┐
│       AI Clients        │    │   MCP Memory Service     │    │ Storage Backend │
│                         │    │         v12.6.0          │    │                 │
│ • Claude Desktop        │◄──►│ • MCP tools              │◄──►│ • Hybrid        │
│ • Claude Code           │    │ • REST API (port 8000)   │    │   (5ms + sync)  │
│ • OpenCode              │    │ • OAuth 2.1              │    │ • SQLite-vec    │
│ • LangGraph / CrewAI    │    │ • Plugin hooks           │    │ • Cloudflare    │
│ • VS Code / Cursor      │    │ • Memory consolidation   │    │ • Milvus        │
│ • 14+ AI apps           │    │ • Quality scoring (ONNX) │    │                 │
│ • Web Dashboard         │    │ • Graph relations        │    │ WAL mode        │
└─────────────────────────┘    └──────────────────────────┘    └─────────────────┘

What's New

v12.6.0 (2026-11-05)

  • Rebuild existing entity graphs with memory_quality(action="rebuild_entities"); preview is the default.
  • Manage registered OAuth clients with memory oauth list-clients and memory oauth delete-client.
  • Dashboard follows the system theme and adds Russian; translations cover more dashboard controls.
  • HTTP /mcp preserves tool annotations, answers ping, and exposes all graph actions.
  • Local unauthenticated HTTP/SSE transports validate Host and Origin to block cross-origin and DNS-rebinding attacks.

v12.5.0 (2026-11-03)

  • Python 3.11+ is required; upgrade Python before updating from a 3.10 installation.
  • Dashboard delta-sync status, entity-tag include/exclude filters and opt-in belief deduplication.

Full history: CHANGELOG ↗


Getting Help

Clone this wiki locally