Skip to main content
Glama
Sceat

Semantic Memory MCP

by Sceat

License: MIT Node.js Redis OpenAI

Semantic memory for AI agents. Store patterns, search by meaning, remember forever.

šŸ“– For LLMs: See ARCHITECTURE.md for detailed implementation & TESTING.md for tool reference


What This Does

Give your AI agents a brain that learns and remembers:

  • 🧠 Semantic Search: Find patterns by meaning, not keywords

  • šŸ’¾ Three Memory Types: Semantic (forever), Episodic (90 days), Procedural (forever)

  • šŸ“ˆ Intelligence Compounds: Learn from every task, recall before you act

  • šŸ”„ Auto-Consolidation: Promotes validated patterns automatically

Related MCP server: Memsolus MCP Server

Quick Start

Install

claude mcp add memory -- npx -y github:Sceat/semantic-memory-mcp

Then configure environment variables in ~/.claude.json:

{
  "mcpServers": {
    "memory": {
      "env": {
        "REDIS_URL": "redis://localhost:6379/0",
        "OPENAI_API_KEY": "your-openai-key-here"
      }
    }
  }
}

Use

Six tools available immediately:

  • store_pattern - Save what you learned

  • search_patterns - Find similar patterns

  • set_reminder - Never forget important details

  • check_reminders - Get context before tasks

  • consolidate_memories - Promote validated patterns

  • health_check - Verify system status


How It Works

ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
│                                                     │
│   Before Task: Query memory for similar patterns   │
│                Check reminders for this task type   │
│                                                     │
│   During Task: Execute with learned context        │
│                                                     │
│   After Task:  Store what you learned              │
│                Set reminders for next time          │
│                                                     │
│   Result: Intelligence compounds over time          │
│                                                     │
ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜

Local Development

If you want to develop or modify the server:

git clone https://github.com/Sceat/semantic-memory-mcp.git
cd semantic-memory-mcp
npm install

Then add to your Claude Code config:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/semantic-memory-mcp/src/index.js"],
      "env": {
        "REDIS_URL": "redis://localhost:6379/0",
        "OPENAI_API_KEY": "your-openai-key-here"
      }
    }
  }
}

Requirements

  • Node.js ≄ 18

  • Redis 7.2+ with RediSearch module

  • OpenAI API key

  • Claude Code


License

MIT

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers