Skip to content

Latest commit

 

History

History
 
 

README.md

@ai-devkit/memory

A lightweight MCP-based memory service for AI agents. Store and retrieve knowledge using SQLite with full-text search.

npm version License: MIT

Features

  • 🔍 Full-Text Search — FTS5 with BM25 ranking
  • 🏷️ Tag-Based Filtering — Organize and find knowledge by tags
  • 📁 Scoped Knowledge — Global, project, or repo-specific rules
  • 🔄 Deduplication — Prevents duplicate content automatically
  • Fast — SQLite with WAL mode, <50ms search latency

Installation

npm install @ai-devkit/memory

Quick Start

Add to your MCP client configuration (e.g., Claude Code, Cursor):

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["@ai-devkit/memory"]
    }
  }
}

Store Knowledge

{
  "tool": "memory.storeKnowledge",
  "arguments": {
    "title": "Always use Response DTOs for API endpoints",
    "content": "When building REST APIs, always use Response DTOs instead of returning domain entities directly.",
    "tags": ["api", "backend", "dto"],
    "scope": "global"
  }
}

Search Knowledge

{
  "tool": "memory.searchKnowledge",
  "arguments": {
    "query": "building an API endpoint",
    "contextTags": ["api"],
    "limit": 5
  }
}

Documentation

📖 For the full API reference, ranking details, and advanced usage, visit:

ai-devkit.com/docs

License

MIT