ken-you-remember

An MCP (Model Context Protocol) server that helps you store and retrieve important information naturally through conversations with AI coding assistants.

Features

🧠 Smart Memory Storage

• Auto-categorization: Automatically detects content types (code, error, solution, warning, tip, config, etc.)
• Intelligent tagging: Extracts relevant tags from content (languages, frameworks, concepts)
• Duplicate detection: Prevents storing the same information twice
• Natural language: Use conversational commands to store and retrieve memories

🔍 Advanced Search

• Fuzzy matching: Finds memories even with typos
• Smart ranking: Frequently accessed memories appear first
• Multi-criteria search: Search by content, tags, or context
• Status-aware: Outdated memories rank lower automatically

🔄 Memory Management

• Freshness tracking: Mark memories as fresh, outdated, or archived
• Review system: Periodic review of old memories to maintain accuracy
• Update capability: Edit existing memories without losing metadata
• Access tracking: See which memories you use most

Installation

Option 1: Install from npm (Recommended)

npm install -g ken-you-remember

Option 2: Install from source

git clone https://github.com/yourusername/ken-you-remember
cd ken-you-remember
npm install
npm run build

Usage with Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "ken-you-remember": {
      "command": "npx",
      "args": ["ken-you-remember"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "ken-you-remember": {
      "command": "ken-you-remember"
    }
  }
}

Available Tools

🔵 remember

Store important information with auto-categorization.

remember(
  content: string,
  tags?: string[],
  context?: string
)

Example:

"Remember that React hooks must be called in the same order"

🔍 recall

Search memories by keyword or tags with smart ranking.

recall(
  query?: string,
  tags?: string[],
  limit?: number
)

Example:

"Recall anything about authentication"

📋 list_memories

Browse recent memories with optional filtering.

list_memories(
  limit?: number,
  tags?: string[]
)

✏️ update_memory

Update existing memories (content, tags, or context).

update_memory(
  id: string,
  content?: string,
  tags?: string[],
  context?: string
)

🗑️ forget

Delete a specific memory by ID.

forget(id: string)

🏷️ list_tags

View all available tags in your memory store.

📄 export_memories

Export all memories to markdown format.

🔄 review_memories

Review and update memory freshness status.

review_memories(
  action: 'list' | 'mark_fresh' | 'mark_outdated' | 'mark_archived',
  days_threshold?: number,
  memory_ids?: string[]
)

Memory Types

• code: Code snippets and implementations
• error: Error messages and stack traces
• solution: Solutions and fixes
• warning: Important warnings and things to avoid
• tip: Best practices and recommendations
• config: Configuration and setup information
• troubleshooting: Debugging tips and fixes
• concept: Concepts, principles, and theories
• command: Terminal commands and CLI operations
• general: Everything else

Smart Features

🎯 Auto-categorization

The system automatically detects the type of content:

• "Never do X" → warning
• "Always do Y" → tip
• "npm install" → command
• Code blocks → code

📊 Smart Ranking

Search results are ranked by:

• Content relevance
• Access frequency
• Recency of access
• Memory freshness status
• Tag matches

🔒 Freshness Management

Keep your knowledge base accurate:

• Fresh memories get priority
• Outdated memories rank lower
• Archived memories appear last
• Review old memories periodically

Resources

The MCP server provides these resources:

• memory://all - All stored memories
• memory://recent - Last 10 memories
• memory://tags - Tag statistics
• memory://stats - Memory statistics
• memory://export - Markdown export

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

License

MIT

Made with ❤️ for developers who forget things