Skip to content

22 Architecture Diagram

Henry edited this page Aug 28, 2026 · 1 revision

Architecture Diagram: MCP Memory Service

An interactive diagram of how the MCP Memory Service is wired up — from the agent through the mcplex gateway to storage, search and deduplication.

➜ Open the diagram

Important

What this diagram shows, and what it does not. It depicts the service as embedded in a local Hermes agent setup. That is one example of how the system can be wired up, not a canonical deployment and not the only valid topology. Your own integration may look quite different — different agent, different gateway, or none at all.

Note

A <iframe> embed used to sit here. The wiki renders neither iframes nor raw HTML, so that embed never worked. The diagram lives on mcpmemory.services and ships with the rest of site/ through .forgejo/workflows/deploy-site.yml. The viewer UI is English.

Viewer features

  • Pan/zoom — move around and magnify
  • Search — jump to a node
  • Focus — highlight one node with its upstream/downstream reach
  • Route probing — trace ordered paths through the system
  • Light/dark theme — toggle
  • Export — PNG, SVG, WebM

Components

Component Role Address
Hermes Agent the AI agent (Qwen3.6-35B) local
MCP Native Client tool discovery and registration mcp_mcplex_gateway_*
mcplex Gateway meta-gateway consolidating all backends http://127.0.0.1:3100
Memory Backend the memory service itself localhost:8000
REST API Layer /api/memories, /api/search, /api/manage/ port 8000
Semantic Search vector similarity over embeddings in-memory
Deduplication content-hash and semantic dedup pre-write
Memory Store the persistent structured database persisted

Guided views

The diagram carries three predefined views:

  1. Full System — complete topology from the Hermes agent through the mcplex gateway to memory storage
  2. Storage Path — follow a memory_store call through to persistent storage
  3. Search Path — trace a memory_search query through semantic search

Related


Metadata

  • Generated with: Archify v2.16, type architecture
  • Validation: 9/9 showcase checks, 0 errors, 0 warnings; visual-check pass at 1440x900, 1600x1000, 1920x1080 and 2048x1320 in light and dark
  • Created: 2026-08-26 · Revised: 2026-08-28 (scope card added)

Clone this wiki locally