claude-conversation-memory-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xiaolai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,223 @@
+# Claude Conversation Memory
+
+A Model Context Protocol (MCP) server that gives Claude Code long-term memory by indexing your conversation history with semantic search, decision tracking, and mistake prevention.
+
+## 💡 What It Does
+
+- **Remembers past conversations** - Search your chat history with natural language
+- **Tracks decisions** - Never forget why you made technical choices
+- **Prevents mistakes** - Learn from past errors and avoid repeating them
+- **Links to git commits** - Connect conversations to code changes
+- **Analyzes file history** - See the complete evolution of files with context
+
+## ⚠️ Important: Claude Code CLI Only
+
+**This MCP server works ONLY with [Claude Code CLI](https://github.com/anthropics/claude-code).**
+
+It does NOT work with:
+- ❌ Claude Desktop
+- ❌ Claude Web
+- ❌ Other Claude integrations
+
+Claude Code CLI is required because it stores conversation history in `~/.claude/projects/` which this MCP indexes.
+
+## 📦 Installation
+
+### Prerequisites
+
+**Required:**
+1. **Claude Code CLI**: https://github.com/anthropics/claude-code
+2. **Node.js**: Version 18 or higher
+3. **sqlite-vec extension**: Automatically loaded (bundled with the package)
+
+**Recommended for better semantic search quality:**
+4. **Ollama**: For high-quality local embeddings
+   ```bash
+   # macOS/Linux
+   curl -fsSL https://ollama.com/install.sh | sh
+
+   # Or download from: https://ollama.com
+   ```
+
+5. **Default embedding model** (if using Ollama):
+   ```bash
+   # Pull the recommended model
+   ollama pull mxbai-embed-large
+
+   # Start Ollama service
+   ollama serve
+   ```
+
+**Note**: Without Ollama, the MCP automatically falls back to Transformers.js (slower but works offline with no setup).
+
+### Install the MCP Server
+
+```bash
+npm install -g claude-conversation-memory-mcp
+```
+
+### Configure Claude Code CLI
+
+Create or edit `~/.claude/config.json`:
+
+```json
+{
+  "mcpServers": {
+    "conversation-memory": {
+      "command": "claude-conversation-memory-mcp"
+    }
+  }
+}
+```
+
+**Alternative: Use npx without global install**
+
+```json
+{
+  "mcpServers": {
+    "conversation-memory": {
+      "command": "npx",
+      "args": ["-y", "claude-conversation-memory-mcp"]
+    }
+  }
+}
+```
+
+### Verify Installation
+
+Start Claude Code CLI and ask:
+
+```
+"Index my conversation history"
+```
+
+If you see a response like "Indexed 3 conversations with 1247 messages", it's working!
+
+## 🎯 Usage Examples
+
+### First Time Setup
+
+```
+You: "Index my conversation history for this project"
+
+Claude: I'll index all conversations for this project...
+✓ Indexed 5 conversations with 2,341 messages
+✓ Semantic search enabled (embeddings generated)
+```
+
+### Search Past Conversations
+
+```
+You: "What did we discuss about the authentication system?"
+
+Claude: Let me search our conversation history...
+[Returns relevant messages with context and timestamps]
+```
+
+### Before Modifying Files
+
+```
+You: "Before I change database.ts, what should I know?"
+
+Claude: Let me check the context for database.ts...
+[Shows recent changes, related decisions, and past mistakes]
+```
+
+### Track Decisions
+
+```
+You: "Why did we choose SQLite over PostgreSQL?"
+
+Claude: Let me check our decision history...
+[Returns the decision with rationale and alternatives considered]
+```
+
+### Learn from Mistakes
+
+```
+You: "Have we had issues with async/await before?"
+
+Claude: Let me search past mistakes...
+[Shows previous errors and how they were fixed]
+```
+
+### Find Related Work
+
+```
+You: "Have we worked on similar API endpoints before?"
+
+Claude: Let me find similar sessions...
+[Returns past conversations about similar work]
+```
+
+### View File History
+
+```
+You: "Show me how auth.ts evolved over time"
+
+Claude: Let me trace the file evolution...
+[Shows complete timeline with conversations, commits, and decisions]
+```
+
+## 🔧 Advanced Usage
+
+### Index Specific Session
+
+```
+You: "Index conversation from session a1172af3-ca62-41be-9b90-701cef39daae"
+```
+
+### Exclude MCP Conversations
+
+By default, conversations about the MCP itself are excluded to prevent self-referential loops. To include them:
+
+```
+You: "Index all conversations, including MCP conversations"
+```
+
+### Search with Date Filters
+
+```
+You: "What were we working on last week?"
+```
+
+### Generate Documentation
+
+```
+You: "Generate project documentation from our conversations"
+```
+
+Claude will create comprehensive docs combining code analysis with conversation history.
+
+## 📚 Learn More
+
+- **[Tool Examples](docs/TOOL-EXAMPLES.md)** - 50+ natural language examples for each tool
+- **[Quick Reference](docs/QUICK-REFERENCE.md)** - Common phrases cheat sheet
+- **[Embeddings FAQ](docs/EMBEDDINGS-FAQ.md)** - How semantic search works
+
+
+## 🐛 Troubleshooting
+
+### "No conversations found"
+
+Make sure you're running this in a directory where you've had Claude Code CLI conversations. Check `~/.claude/projects/` to verify conversation files exist.
+
+### "Embeddings failed"
+
+The MCP falls back to full-text search if embeddings fail. Everything still works, just without semantic search.
+
+### "MCP not responding"
+
+Restart Claude Code CLI to reload the MCP server.
+
+## 📄 License
+
+MIT License - See [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+Inspired by [code-graph-rag-mcp](https://github.com/er77/code-graph-rag-mcp).
+
+---
+
+**Made with ❤️ for the Claude Code CLI community**

package/dist/ConversationMemory.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Main Orchestrator - Coordinates all components
+ */
+import { ConversationStorage } from "./storage/ConversationStorage.js";
+import { SemanticSearch } from "./search/SemanticSearch.js";
+export interface IndexOptions {
+    projectPath: string;
+    sessionId?: string;
+    includeThinking?: boolean;
+    enableGitIntegration?: boolean;
+    excludeMcpConversations?: boolean | 'self-only' | 'all-mcp';
+    excludeMcpServers?: string[];
+}
+export declare class ConversationMemory {
+    private sqliteManager;
+    private storage;
+    private parser;
+    private decisionExtractor;
+    private mistakeExtractor;
+    private requirementsExtractor;
+    private semanticSearch;
+    constructor();
+    /**
+     * Index conversations for a project
+     */
+    indexConversations(options: IndexOptions): Promise<{
+        embeddings_generated: boolean;
+        embedding_error?: string;
+    }>;
+    /**
+     * Search conversations
+     */
+    search(query: string, limit?: number): Promise<import("./search/SemanticSearch.js").SearchResult[]>;
+    /**
+     * Search decisions
+     */
+    searchDecisions(query: string, limit?: number): Promise<import("./search/SemanticSearch.js").DecisionSearchResult[]>;
+    /**
+     * Get file timeline
+     */
+    getFileTimeline(filePath: string): {
+        file_path: string;
+        edits: import("./parsers/ConversationParser.js").FileEdit[];
+        commits: import("./parsers/GitIntegrator.js").GitCommit[];
+        decisions: import("./parsers/DecisionExtractor.js").Decision[];
+    };
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        conversations: {
+            count: number;
+        };
+        messages: {
+            count: number;
+        };
+        decisions: {
+            count: number;
+        };
+        mistakes: {
+            count: number;
+        };
+        git_commits: {
+            count: number;
+        };
+    };
+    /**
+     * Get storage instance
+     */
+    getStorage(): ConversationStorage;
+    /**
+     * Get semantic search instance
+     */
+    getSemanticSearch(): SemanticSearch;
+    /**
+     * Filter MCP conversations from parse results
+     */
+    private filterMcpConversations;
+}
+//# sourceMappingURL=ConversationMemory.d.ts.map

package/dist/ConversationMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationMemory.d.ts","sourceRoot":"","sources":["../src/ConversationMemory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAMvE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uBAAuB,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,cAAc,CAAiB;;IAYvC;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,oBAAoB,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA4GrH;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;IAI9C;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;IAIvD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM;;;;;;IAIhC;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;IAIR;;OAEG;IACH,UAAU;IAIV;;OAEG;IACH,iBAAiB;IAIjB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA2D/B"}

package/dist/ConversationMemory.js

@@ -0,0 +1,203 @@
+/**
+ * Main Orchestrator - Coordinates all components
+ */
+import { getSQLiteManager } from "./storage/SQLiteManager.js";
+import { ConversationStorage } from "./storage/ConversationStorage.js";
+import { ConversationParser } from "./parsers/ConversationParser.js";
+import { DecisionExtractor } from "./parsers/DecisionExtractor.js";
+import { MistakeExtractor } from "./parsers/MistakeExtractor.js";
+import { GitIntegrator } from "./parsers/GitIntegrator.js";
+import { RequirementsExtractor } from "./parsers/RequirementsExtractor.js";
+import { SemanticSearch } from "./search/SemanticSearch.js";
+export class ConversationMemory {
+    sqliteManager;
+    storage;
+    parser;
+    decisionExtractor;
+    mistakeExtractor;
+    requirementsExtractor;
+    semanticSearch;
+    constructor() {
+        this.sqliteManager = getSQLiteManager();
+        this.storage = new ConversationStorage(this.sqliteManager);
+        this.parser = new ConversationParser();
+        this.decisionExtractor = new DecisionExtractor();
+        this.mistakeExtractor = new MistakeExtractor();
+        this.requirementsExtractor = new RequirementsExtractor();
+        this.semanticSearch = new SemanticSearch(this.sqliteManager);
+    }
+    /**
+     * Index conversations for a project
+     */
+    async indexConversations(options) {
+        console.log("\n=== Indexing Conversations ===");
+        console.log(`Project: ${options.projectPath}`);
+        if (options.sessionId) {
+            console.log(`Session: ${options.sessionId} (single session mode)`);
+        }
+        else {
+            console.log(`Mode: All sessions`);
+        }
+        // Parse conversations
+        let parseResult = this.parser.parseProject(options.projectPath, options.sessionId);
+        // Filter MCP conversations if requested
+        if (options.excludeMcpConversations || options.excludeMcpServers) {
+            parseResult = this.filterMcpConversations(parseResult, options);
+        }
+        // Store basic entities
+        await this.storage.storeConversations(parseResult.conversations);
+        await this.storage.storeMessages(parseResult.messages);
+        await this.storage.storeToolUses(parseResult.tool_uses);
+        await this.storage.storeToolResults(parseResult.tool_results);
+        await this.storage.storeFileEdits(parseResult.file_edits);
+        if (options.includeThinking !== false) {
+            await this.storage.storeThinkingBlocks(parseResult.thinking_blocks);
+        }
+        // Extract decisions
+        console.log("\n=== Extracting Decisions ===");
+        const decisions = this.decisionExtractor.extractDecisions(parseResult.messages, parseResult.thinking_blocks);
+        await this.storage.storeDecisions(decisions);
+        // Extract mistakes
+        console.log("\n=== Extracting Mistakes ===");
+        const mistakes = this.mistakeExtractor.extractMistakes(parseResult.messages, parseResult.tool_results);
+        await this.storage.storeMistakes(mistakes);
+        // Extract requirements and validations
+        console.log("\n=== Extracting Requirements ===");
+        const requirements = this.requirementsExtractor.extractRequirements(parseResult.messages);
+        await this.storage.storeRequirements(requirements);
+        const validations = this.requirementsExtractor.extractValidations(parseResult.tool_uses, parseResult.tool_results, parseResult.messages);
+        await this.storage.storeValidations(validations);
+        // Git integration
+        if (options.enableGitIntegration !== false) {
+            try {
+                console.log("\n=== Integrating Git History ===");
+                const gitIntegrator = new GitIntegrator(options.projectPath);
+                const commits = await gitIntegrator.linkCommitsToConversations(parseResult.conversations, parseResult.file_edits, decisions);
+                await this.storage.storeGitCommits(commits);
+                console.log(`✓ Linked ${commits.length} git commits`);
+            }
+            catch (error) {
+                console.error("⚠️ Git integration failed:", error);
+                console.error("  Conversations will be indexed without git commit links");
+                console.error("  This is normal if the project is not a git repository");
+            }
+        }
+        // Index for semantic search
+        console.log("\n=== Indexing for Semantic Search ===");
+        let embeddingError;
+        try {
+            await this.semanticSearch.indexMessages(parseResult.messages);
+            await this.semanticSearch.indexDecisions(decisions);
+            console.log("✓ Semantic indexing complete");
+        }
+        catch (error) {
+            embeddingError = error.message;
+            console.error("⚠️ Semantic indexing failed:", error);
+            console.error("  Embeddings may not be available - falling back to full-text search");
+            console.error("  Install @xenova/transformers for semantic search: npm install @xenova/transformers");
+            // Don't throw - allow indexing to complete with FTS fallback
+        }
+        // Print stats
+        console.log("\n=== Indexing Complete ===");
+        const stats = this.storage.getStats();
+        console.log(`Conversations: ${stats.conversations.count}`);
+        console.log(`Messages: ${stats.messages.count}`);
+        console.log(`Decisions: ${stats.decisions.count}`);
+        console.log(`Mistakes: ${stats.mistakes.count}`);
+        console.log(`Git Commits: ${stats.git_commits.count}`);
+        // Return embedding status
+        return {
+            embeddings_generated: !embeddingError,
+            embedding_error: embeddingError
+        };
+    }
+    /**
+     * Search conversations
+     */
+    async search(query, limit = 10) {
+        return this.semanticSearch.searchConversations(query, limit);
+    }
+    /**
+     * Search decisions
+     */
+    async searchDecisions(query, limit = 10) {
+        return this.semanticSearch.searchDecisions(query, limit);
+    }
+    /**
+     * Get file timeline
+     */
+    getFileTimeline(filePath) {
+        return this.storage.getFileTimeline(filePath);
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return this.storage.getStats();
+    }
+    /**
+     * Get storage instance
+     */
+    getStorage() {
+        return this.storage;
+    }
+    /**
+     * Get semantic search instance
+     */
+    getSemanticSearch() {
+        return this.semanticSearch;
+    }
+    /**
+     * Filter MCP conversations from parse results
+     */
+    filterMcpConversations(result, options) {
+        const shouldExcludeConversation = (conv) => {
+            const metadata = conv.metadata;
+            if (!metadata.mcp_usage?.detected) {
+                return false; // No MCP usage, don't exclude
+            }
+            // Check exclude_mcp_servers first (most specific)
+            if (options.excludeMcpServers && options.excludeMcpServers.length > 0) {
+                return metadata.mcp_usage.servers.some(server => options.excludeMcpServers?.includes(server));
+            }
+            // Check exclude_mcp_conversations setting
+            if (options.excludeMcpConversations === 'self-only') {
+                return metadata.mcp_usage.servers.includes('conversation-memory');
+            }
+            if (options.excludeMcpConversations === 'all-mcp' || options.excludeMcpConversations === true) {
+                return true; // Exclude all MCP conversations
+            }
+            return false;
+        };
+        // Build set of excluded conversation IDs
+        const excludedConvIds = new Set(result.conversations
+            .filter(shouldExcludeConversation)
+            .map(c => c.id));
+        if (excludedConvIds.size > 0) {
+            console.log(`\n⚠️ Excluding ${excludedConvIds.size} MCP conversation(s) from indexing`);
+        }
+        // Filter all related entities
+        return {
+            conversations: result.conversations.filter(c => !excludedConvIds.has(c.id)),
+            messages: result.messages.filter(m => !excludedConvIds.has(m.conversation_id)),
+            tool_uses: result.tool_uses.filter(t => {
+                const msg = result.messages.find(m => m.id === t.message_id);
+                return msg && !excludedConvIds.has(msg.conversation_id);
+            }),
+            tool_results: result.tool_results.filter(tr => {
+                const toolUse = result.tool_uses.find(tu => tu.id === tr.tool_use_id);
+                if (!toolUse) {
+                    return false;
+                }
+                const msg = result.messages.find(m => m.id === toolUse.message_id);
+                return msg && !excludedConvIds.has(msg.conversation_id);
+            }),
+            file_edits: result.file_edits.filter(fe => !excludedConvIds.has(fe.conversation_id)),
+            thinking_blocks: result.thinking_blocks.filter(tb => {
+                const msg = result.messages.find(m => m.id === tb.message_id);
+                return msg && !excludedConvIds.has(msg.conversation_id);
+            }),
+        };
+    }
+}
+//# sourceMappingURL=ConversationMemory.js.map

package/dist/ConversationMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationMemory.js","sourceRoot":"","sources":["../src/ConversationMemory.ts"],"names":[],"mappings":"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"}

package/dist/documentation/CodeAnalyzer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CodeAnalyzer - Processes code graph data from CODE-GRAPH-RAG-MCP
+ *
+ * Note: This class processes data that should be fetched from CODE-GRAPH-RAG-MCP
+ * The actual MCP calls should be made by the tool handler and passed to this analyzer
+ */
+import type { CodeData, RawEntity, RawHotspot, RawClone } from './types.js';
+export interface CodeGraphRagData {
+    entities?: RawEntity[];
+    hotspots?: RawHotspot[];
+    clones?: RawClone[];
+    graph?: Record<string, unknown>;
+}
+export declare class CodeAnalyzer {
+    /**
+     * Process code graph data from CODE-GRAPH-RAG-MCP
+     */
+    analyze(codeGraphData: CodeGraphRagData): Promise<CodeData>;
+    private parseEntities;
+    private normalizeEntityType;
+    private groupEntitiesByFile;
+    private parseHotspots;
+    private parseClones;
+    /**
+     * Extract file paths from code data for cross-referencing
+     */
+    extractFilePaths(codeData: CodeData): string[];
+}
+//# sourceMappingURL=CodeAnalyzer.d.ts.map

package/dist/documentation/CodeAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeAnalyzer.d.ts","sourceRoot":"","sources":["../../src/documentation/CodeAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EAKR,SAAS,EACT,UAAU,EACV,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,qBAAa,YAAY;IACvB;;OAEG;IACG,OAAO,CAAC,aAAa,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBjE,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE;CAqB/C"}