A
licenseA
qualityC
maintenanceSmart memory for AI agents. Solves the Karpathy problem: memories decay, topics are frequency-weighted, one-time questions don't become obsessions. 7 tools. Zero deps.
Last updated
4
21
2
MIT
nexus-memory
by Y-Sky-bro
Allows AI agents in the Hermes ecosystem to share and retrieve memories using Nexus Memory System, acting as a drop-in replacement for Hindsight.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@nexus-memorysave that my project deadline is next Friday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Nexus Memory System
Zero-dependency, file-based persistent memory for AI agents.
Nexus is a tiered memory system with Ebbinghaus decay, keyword retrieval, token-efficient context assembly, and full MCP + REST API support. Drop-in replacement for Hindsight that saves 92% on memory token costs.
MCP Server → stdio (Claude Code, Cline, Windsurf)
REST API → HTTP (Hermes agents, custom integrations)
CLI → bash (nexus.sh — search, stats, decay, consolidate)Features
Feature | Description |
Zero dependencies | No database, no vector store, no embeddings API. Pure Python stdlib. |
MCP native | 5 tools (search, stats, save, touch, decay) + resource access |
REST API | Hindsight v1 compatible. Drop-in replace |
Ebbinghaus decay | Automatic forgetting curve. Memories expire on schedule. |
Token economics | 92% cost reduction vs Hindsight. Built-in token tracking. |
Pointer-based RAG | Kronos-style 300-token pointers for budgeted context assembly. |
File-based | Plain markdown files. Readable, editable, git-versionable. |
Bilingual | Full Chinese + English support. |
Cross-agent sharing | Share memories across Hermes agents or any MCP client. |
Related MCP server: Memory Search MCP Server
Quick Start
# 1. Start the MCP server (for Claude Code / Cline / Windsurf)
python nexus_mcp.py
# 2. Start the REST API (for Hermes agents / HTTP clients)
python nexus_rest.py --port 9177
# 3. Use the CLI
python nexus_engine.py retrieve "what do I know about X"
python nexus_engine.py stats
python nexus_engine.py decayClaude Code Integration
Add to your claude.json:
{
"mcpServers": {
"nexus-memory": {
"command": "python",
"args": ["path/to/nexus_mcp.py"]
}
}
}Hermes Agent Integration
Replace Hindsight with Nexus:
export HINDSIGHT_API_URL=http://localhost:9177No code changes needed. Nexus speaks the Hindsight v1 protocol.
Architecture
┌─────────────────────────────────────────────────────┐
│ Nexus System │
│ │
│ ┌──────────────┐ ┌──────────┐ ┌───────────────┐ │
│ │ nexus_mcp.py │ │nexus_rest│ │nexus_engine.py│ │
│ │ (MCP stdio) │ │(HTTP API)│ │ (Core logic) │ │
│ └──────┬───────┘ └────┬─────┘ └───────┬───────┘ │
│ └───────────────┼─────────────────┘ │
│ ▼ │
│ ┌──────────────────┐ │
│ │ memory/ (files) │ │
│ │ ├ episodic/ │ │
│ │ ├ semantic/ │ │
│ │ ├ procedural/ │ │
│ │ ├ reflections/ │ │
│ │ ├ working/ │ │
│ │ ├ core/ │ │
│ │ └ archive/ │ │
│ └──────────────────┘ │
└─────────────────────────────────────────────────────┘Memory Tiers
Tier | Decay | Purpose |
Working | 7 days | In-session context |
Episodic | 30 days | Past experiences |
Semantic | 90 days | Facts, preferences |
Procedural | 180 days | Workflows, skills |
Reflections | 60 days | Meta-cognition |
Core | Never | Identity, rules |
Token Economics
Metric | Hindsight | Nexus | Savings |
Per recall | 500 tokens | 30 tokens | 94% |
Per retain | 300 tokens | 50 tokens | 83% |
5 agents/day | 440,000 tokens | 36,000 tokens | 92% |
Monthly cost | $39.60 | $3.24 | $36.36 |
Benchmark: 1192.9x efficiency ratio (1 token spent → 1192 saved vs Hindsight).
Pricing
Free Solo Team Enterprise
───── ────── ────── ──────────
Price $0 $4.99/mo $14.99/mo $49.99/mo
Memories 50 500 5,000 50,000
MCP ✓ ✓ ✓ ✓
REST API ✓ ✓ ✓ ✓
CLI ✓ ✓ ✓ ✓
Pointers - ✓ ✓ ✓
Token 7 days 30 days 90 days 365 days
tracking
Cross- - - ✓ ✓
agent
Priority - - - ✓
supportAll tiers include Ebbinghaus decay, keyword retrieval, and file-based transparency.
Roadmap
MCP server (tools + resources)
REST API (Hindsight v1 compatible)
Keyword retrieval + scoring
Token economics tracking
Ebbinghaus decay
Memory consolidation
x402 micropayments
SSE transport for MCP
Cloud sync
Knowledge graph
Why Not Hindsight?
Hindsight is powerful but expensive: it calls LLMs for every recall/retain, uses PostgreSQL + pgvector, and requires a running daemon. Nexus achieves comparable retrieval quality at 8% of the token cost — no LLM calls, no database, no daemon. Just files and algorithms.
Why Not Mem0/Letta/Memoria?
Those are excellent systems, but they're architecturally heavy (vector DBs, embeddings, graph stores). Nexus is designed for the 80% use case: fast keyword retrieval with smart ranking. When you need semantic search, Nexus pointers bridge the gap at zero marginal cost.
No database. No API keys. No Docker. Just python nexus_mcp.py.
Built with ❤️ for the Hermes agent ecosystem.
Maintenance
–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityAmaintenancePersistent memory system for AI agents that records episodic memories with care-weighting and emotional valence, and provides full-text search with temporal chaining and automatic consolidation.Last updatedMIT
- Alicense-qualityCmaintenanceProvides persistent long-term memory for AI agents with semantic search and activation-based decay. Enables AI systems to remember across sessions through layered memory architecture and automatic context-aware retrieval.Last updated32MIT
- AlicenseAqualityCmaintenancePortable cognitive memory for AI agents with semantic search, decay, and deduplication.Last updated8402MIT
Related MCP Connectors
Persistent memory for AI agents. Search, store, and recall across sessions.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Persistent memory and knowledge graphs for AI agents. Hybrid search, context checkpoints, and more.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Y-Sky-bro/nexus-memory'
If you have feedback or need assistance with the MCP directory API, please join our Discord server