alaya-mcp

alaya-mcp

A local memory engine for AI agents. Stores conversation episodes, consolidates knowledge through a neuroscience-inspired lifecycle, and builds a personal knowledge graph — all in a local SQLite database.

Install

Claude Code

Add to ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "alaya": {
      "command": "npx",
      "args": ["-y", "alaya-mcp"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop MCP config:

{
  "mcpServers": {
    "alaya": {
      "command": "npx",
      "args": ["-y", "alaya-mcp"],
      "env": {
        "ALAYA_LLM_API_KEY": "sk-...",
        "ALAYA_LLM_API_URL": "https://api.openai.com/v1/chat/completions",
        "ALAYA_LLM_MODEL": "gpt-4o-mini"
      }
    }
  }
}

The ALAYA_LLM_* env vars are optional — they enable automatic knowledge extraction. Without them, the agent extracts knowledge from its own context.

MCP Tools

Tool	Description
remember	Store a conversation episode
recall	Semantic search across memories
status	Memory system health and stats
knowledge	Browse extracted knowledge
learn	Store pre-extracted facts and relationships
categories	View emergent category taxonomy
preferences	Track crystallized user preferences
neighbors	Explore the knowledge graph
lifecycle	Trigger maintenance (strengthen, transform, forget)
configure	Set embedding provider and other options

How It Works

• Remember — store conversation episodes as they happen
• Consolidate — extract facts, relationships, and concepts from episodes
• Strengthen — frequently accessed memories grow stronger (Bjork model)
• Categorize — emergent categories form automatically from your knowledge
• Forget — weak, unused memories fade naturally over time

All data stays on your machine in ~/.alaya/memory.db.

Links

• GitHub
• Documentation
• crates.io (Rust library)

License

MIT