Skip to content

v1.3.0 — MCP Server & Structured Memory

Choose a tag to compare

@kunwar-shah kunwar-shah released this 12 Feb 13:09
· 25 commits to main since this release
9860e7d

What's New

MCP Server for Claude Code

Claudex now includes a Model Context Protocol (MCP) server that gives Claude Code persistent memory across sessions. Claude can remember your codebase conventions, architecture decisions, error patterns, and more.

One-command setup:

npm install -g @kunwarshah/claudex
claude mcp add --transport stdio claudex -- claudex-mcp

10 MCP Tools

Tool Description
get_project_context Condensed project snapshot (call this first!)
list_projects List all Claude Code projects
list_sessions List sessions for a project
search_conversations Full-text search across conversations
get_session Get full conversation from a session
get_session_summary Get session metadata and stats
store_memory Store structured coding knowledge
recall_memory Recall stored memories by namespace/type
list_memories List all stored memories with stats
delete_memory Delete outdated or incorrect memories

Structured Memory System

Store coding knowledge in SQLite with:

  • 6 memory types: map, convention, decision, snapshot, dependency, error_pattern
  • Priority (1-10): Higher priority memories injected first
  • Confidence (0.0-1.0): Track certainty of memories
  • TTL: Auto-expire stale memories (useful for focus/blocker snapshots)

Token Budgeting

Three detail levels for get_project_context:

  • minimal (~500 tokens) — project stats + session titles
  • standard (~1500 tokens) — recent sessions + high-priority memories
  • full (~3000+ tokens) — all sessions + all memories

3 MCP Prompts

  • /mcp__claudex__recall — Search conversation history for a topic
  • /mcp__claudex__catchup — Get summary of recent project work
  • /mcp__claudex__history — Browse recent sessions with titles

MCP Resources

  • claudex://projects — All projects with session counts
  • claudex://projects/{id}/recent — Recent sessions for a project

Documentation

Install / Upgrade

npm install -g @kunwarshah/claudex@1.3.0