MCP Memory Service Architecture

MCP Memory Service Architecture An architecture diagram generated by Archify. Hermes Agent · Qwen3.6-35B · Hermes Agent · AI Agent Hermes Agent Qwen3.6-35B AI Agent MCP Native Client · Tool Discovery · Hermes Agent MCP Native Client Tool Discovery mcplex Gateway · http://127.0.0.1:3100 · mcplex Gateway · Meta-Gateway mcplex Gateway http://127.0.0.1:3100 Meta-Gateway Memory Backend · localhost:8000 · MCP Memory Service Memory Backend localhost:8000 REST API Layer · /api/memories, /api/search · MCP Memory Service REST API Layer /api/memories, /api/search Semantic Search · Vector Similarity · MCP Memory Service Semantic Search Vector Similarity Deduplication · content_hash · MCP Memory Service · semantic dedup Deduplication content_hash semantic dedup Memory Store · Structured DB · MCP Memory Service Memory Store Structured DB Registered Tools · mcp_mcplex_gateway_* · Hermes Agent Registered Tools mcp_mcplex_gateway_* tool discovery HTTP MCP query CRUD vector scan Hermes Agent mcplex Gateway MCP Memory Service

Discovery

  • • Hermes Agent discovers tools at startup via MCP protocol
  • • Tools registered with prefix mcp_mcplex_gateway_*
  • • Persistent connections with auto-reconnect (5 retries, exponential backoff)

Storage

  • • Structured memory store with semantic deduplication
  • • content_hash prevents duplicate storage
  • • Supports tags, memory_type, and metadata

Search

  • • Semantic search with quality boost (0.0–1.0)
  • • Exact mode for precise string matching
  • • Hybrid mode combines semantics + quality scoring