A Model Context Protocol server that provides knowledge graph management capabilities. This server enables LLMs to create, read, update, and delete entities and relations in a persistent knowledge graph, helping AI assistants maintain memory across conversations. This is a Go implementation of the official TypeScript Memory MCP Server.
A Model Context Protocol server that provides knowledge graph management capabilities.
—
Features
High-Performance Storage: SQLite backend with WAL mode, read/write connection separation for concurrent access
Knowledge Graph Management: Persistent graph of entities, relationships, and observations
Advanced Search: FTS5 full-text search with BM25 ranking, synonym expansion, and time-decay scoring
Graph Traversal: Search results include 1-hop related entities for richer context
For remote deployment with OAuth 2.1 authentication, compatible with Claude Desktop's Custom Connectors:
# Start server with OAuth
mms --transport http --host 127.0.0.1 --oauth-user admin --oauth-pass secret --oauth-store /var/lib/mms/oauth.db --port 8080
# Or with environment variables and explicit issuer
OAUTH_USER=admin OAUTH_PASS=secret OAUTH_STORE_PATH=/var/lib/mms/oauth.db \
OAUTH_REFRESH_REPLAY_GRACE=24h \
mms --transport http --oauth-issuer https://mcp.example.com
Then in Claude Desktop: Settings → Connectors → Add Custom Connector → enter your server URL (e.g., https://mcp.example.com/mcp). Claude will automatically discover the OAuth endpoints and prompt you to log in.
You have access to a Knowledge Graph memory system that persists across conversations.
Saving memories:
- create_entities: Add new people, places, concepts (check search_nodes first to avoid duplicates)
- create_relations: Record how entities relate to each other
- add_observations: Add facts to existing entities
Retrieving memories:
- search_nodes: Find relevant entities by keyword (supports synonyms like JS→JavaScript)
- open_nodes: Get full details of specific entities
- read_graph: Get an overview of all stored knowledge (use "summary" mode first)
Managing memories:
- merge_entities: Combine duplicate entities
- detect_conflicts: Find contradictory observations
- update_entities / update_observations: Fix incorrect data
Always check your memory before answering questions that might require past context.
Streamable HTTP Usage
The Streamable HTTP endpoint accepts JSON-RPC requests, notifications, and
responses. Client responses such as replies to server ping messages are
acknowledged with 202 Accepted and no body, per the MCP transport spec.
Deploy behind TLS (Nginx/Caddy/Traefik), bind server to localhost
Simple auth: Use --auth-bearer $(openssl rand -hex 32) for programmatic clients
OAuth 2.1: Use --oauth-user/--oauth-pass for browser-based login (Claude Desktop Connectors). Set --oauth-store in production so registered clients and tokens survive restarts, and run the service with a restrictive umask such as systemd UMask=0077 to protect SQLite WAL/SHM files. Supports PKCE (S256), dynamic client registration, durable token storage, and refresh token rotation with a replay grace window for concurrent or multi-worker clients. Use --oauth-refresh-replay-grace for clients that keep stale refresh tokens in multiple processes
Forward Authorization header from reverse proxy to backend; set --oauth-issuer to the public URL when behind a proxy
Run as non-root, open only required ports, enable rate limiting for untrusted clients
Storage System
Storage Types
SQLite (Recommended)
JSONL (Legacy)
Read/Search
1.9x faster
Baseline
Memory
1.9x more efficient
Baseline
File Size
Larger
3x smaller
Startup
Slower
55x faster
Features
FTS5, ACID, WAL, concurrent reads
Human-readable
Best For
>100 entities
<50 entities
Migration
# Automatic (default): just use your existing JSONL path
mms --memory /path/to/memory.json # auto-migrates to .db
# Manual migration
mms --migrate /path/to/memory.json --migrate-to /path/to/memory.db
# Dry run
mms --migrate /path/to/memory.json --dry-run
Knowledge Graph Structure
Entities: Nodes with a name, type, and list of observations (each with optional metadata: source, confidence, tags)
Relations: Directed edges between entities with a relation type in active voice
Observations: Atomic facts associated with entities, supporting time-decay ranking based on access patterns
Merges all observations and relations from "React.js" into "React", then deletes "React.js".
Detecting Conflicts
{
"entityName": "John Smith"
}
Returns potential duplicates (>60% prefix overlap) and contradictions (antonym keyword pairs like "likes/dislikes").
Development
make fmt # Format code
make check # Static analysis (gofmt + go vet)
go test ./... # Run tests
make build # Build binary
# Full verification
make fmt && make check && go test ./... && make build
Requirements
Go 1.24+
github.com/mark3labs/mcp-go v0.19.0+
modernc.org/sqlite (pure Go SQLite, no CGO)
Versioning
Version is managed via the VERSION file. Override with make build VERSION=1.2.3 or go build -ldflags "-X main.version=1.2.3".
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Memory MCP Server Go?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Memory MCP Server Go precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Memory MCP Server Go usa?
Memory MCP Server Go roda localmente via stdio.
Quando Memory MCP Server Go foi verificado pela última vez?
Última verificação: 2026-10-27. A Model Context Protocol server that provides knowledge graph management capabilities.