mnemosyne-mcp-server

Scope

This page is the repository hub for the semantic memory service.

Current Synthesis

mnemosyne-mcp-server/ is a Go MCP server that provides semantic memory ingestion, retrieval, listing, and deletion backed by Postgres plus vector search. It is the semantic retrieval layer of TazLab and is deployed in the cluster as mnemosyne-mcp.

Main Responsibilities

• expose MCP tools for memory CRUD and semantic retrieval
• generate Gemini embeddings and persist memory records
• serve either stdio or Streamable HTTP transport modes
• act as the retrieval service behind the mnemosyne knowledge layer

Important Operational Characteristics

• uses gemini-embedding-001
• assumes an external memories table exists
• follows GitOps deployment through image build plus Flux reconciliation rather than manual deployment

Relationships

• defined as the semantic layer in TazLab Knowledge Layers
• deployed through tazlab-k8s
• complements the active memory in AGENTS.ctx
• contributes to the TazLab System Map

Source Basis

• AGENTS.ctx/mnemosyne-mcp-server/CONTEXT.md
• AGENTS.ctx/memory/system-state.md