claude-conversation-memory-mcp 0.1.0

package/dist/types/ToolTypes.d.ts

@@ -0,0 +1,333 @@
+/**
+ * Type definitions for MCP Tool arguments and responses
+ * Replaces 'any' types with proper interfaces for type safety
+ */
+export interface IndexConversationsArgs {
+    project_path?: string;
+    session_id?: string;
+    include_thinking?: boolean;
+    enable_git?: boolean;
+    exclude_mcp_conversations?: boolean | 'self-only' | 'all-mcp';
+    exclude_mcp_servers?: string[];
+}
+export interface SearchConversationsArgs {
+    query: string;
+    limit?: number;
+    date_range?: [number, number];
+}
+export interface GetDecisionsArgs {
+    query: string;
+    file_path?: string;
+    limit?: number;
+}
+export interface CheckBeforeModifyArgs {
+    file_path: string;
+}
+export interface GetFileEvolutionArgs {
+    file_path: string;
+    include_decisions?: boolean;
+    include_commits?: boolean;
+}
+export interface LinkCommitsToConversationsArgs {
+    query?: string;
+    conversation_id?: string;
+    limit?: number;
+}
+export interface SearchMistakesArgs {
+    query: string;
+    mistake_type?: string;
+    limit?: number;
+}
+export interface GetRequirementsArgs {
+    component: string;
+    type?: string;
+}
+export interface GetToolHistoryArgs {
+    tool_name?: string;
+    file_path?: string;
+    limit?: number;
+}
+export interface FindSimilarSessionsArgs {
+    query: string;
+    limit?: number;
+}
+export interface GenerateDocumentationArgs {
+    project_path?: string;
+    session_id?: string;
+    scope?: 'full' | 'architecture' | 'decisions' | 'quality';
+    module_filter?: string;
+}
+export interface IndexConversationsResponse {
+    success: boolean;
+    project_path: string;
+    stats: {
+        conversations: {
+            count: number;
+        };
+        messages: {
+            count: number;
+        };
+        decisions: {
+            count: number;
+        };
+        mistakes: {
+            count: number;
+        };
+        git_commits: {
+            count: number;
+        };
+    };
+    embeddings_generated?: boolean;
+    embedding_error?: string;
+    message: string;
+}
+export interface SearchResult {
+    conversation_id: string;
+    message_id: string;
+    timestamp: string;
+    similarity: number;
+    snippet: string;
+    git_branch?: string;
+    message_type: string;
+    role?: string;
+}
+export interface SearchConversationsResponse {
+    query: string;
+    results: SearchResult[];
+    total_found: number;
+}
+export interface DecisionResult {
+    decision_id: string;
+    decision_text: string;
+    rationale?: string;
+    alternatives_considered: string[];
+    rejected_reasons: Record<string, string>;
+    context?: string;
+    related_files: string[];
+    related_commits: string[];
+    timestamp: string;
+    similarity: number;
+}
+export interface GetDecisionsResponse {
+    query: string;
+    file_path?: string;
+    decisions: DecisionResult[];
+    total_found: number;
+}
+export interface EditInfo {
+    timestamp: string;
+    conversation_id: string;
+}
+export interface CommitInfo {
+    hash: string;
+    message: string;
+    timestamp: string;
+}
+export interface DecisionInfo {
+    decision_text: string;
+    rationale?: string;
+    timestamp: string;
+}
+export interface MistakeInfo {
+    what_went_wrong: string;
+    correction?: string;
+    mistake_type: string;
+}
+export interface CheckBeforeModifyResponse {
+    file_path: string;
+    warning: string;
+    recent_changes: {
+        edits: EditInfo[];
+        commits: CommitInfo[];
+    };
+    related_decisions: DecisionInfo[];
+    mistakes_to_avoid: MistakeInfo[];
+}
+export interface TimelineEvent {
+    type: 'edit' | 'commit' | 'decision';
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+export interface GetFileEvolutionResponse {
+    file_path: string;
+    total_edits: number;
+    timeline: TimelineEvent[];
+}
+export interface CommitResult {
+    hash: string;
+    full_hash: string;
+    message: string;
+    author?: string;
+    timestamp: string;
+    branch?: string;
+    files_changed: string[];
+    conversation_id?: string;
+}
+export interface LinkCommitsToConversationsResponse {
+    query?: string;
+    conversation_id?: string;
+    commits: CommitResult[];
+    total_found: number;
+}
+export interface MistakeResult {
+    mistake_id: string;
+    mistake_type: string;
+    what_went_wrong: string;
+    correction?: string;
+    user_correction_message?: string;
+    files_affected: string[];
+    timestamp: string;
+}
+export interface SearchMistakesResponse {
+    query: string;
+    mistake_type?: string;
+    mistakes: MistakeResult[];
+    total_found: number;
+}
+export interface RequirementResult {
+    requirement_id: string;
+    type: string;
+    description: string;
+    rationale?: string;
+    affects_components: string[];
+    timestamp: string;
+}
+export interface GetRequirementsResponse {
+    component: string;
+    type?: string;
+    requirements: RequirementResult[];
+    total_found: number;
+}
+export interface ToolUseResult {
+    tool_use_id: string;
+    tool_name: string;
+    tool_input: Record<string, unknown>;
+    result: {
+        content?: string;
+        is_error: boolean;
+        stdout?: string;
+        stderr?: string;
+    };
+    timestamp: string;
+}
+export interface GetToolHistoryResponse {
+    tool_name?: string;
+    file_path?: string;
+    tool_uses: ToolUseResult[];
+    total_found: number;
+}
+export interface RelevantMessage {
+    message_id: string;
+    snippet: string;
+    similarity: number;
+}
+export interface SessionResult {
+    conversation_id: string;
+    project_path: string;
+    first_message_at: string;
+    message_count: number;
+    git_branch?: string;
+    relevance_score: number;
+    relevant_messages: RelevantMessage[];
+}
+export interface FindSimilarSessionsResponse {
+    query: string;
+    sessions: SessionResult[];
+    total_found: number;
+}
+export interface GenerateDocumentationResponse {
+    success: boolean;
+    project_path: string;
+    scope: string;
+    documentation: string;
+    statistics: {
+        modules: number;
+        decisions: number;
+        mistakes: number;
+        commits: number;
+    };
+}
+export interface ConversationRow {
+    id: string;
+    project_path: string;
+    first_message_at: number;
+    last_message_at: number;
+    message_count: number;
+    git_branch?: string;
+    claude_version?: string;
+    metadata: string;
+    created_at: number;
+    updated_at: number;
+}
+export interface MessageRow {
+    id: string;
+    conversation_id: string;
+    parent_id?: string;
+    message_type: string;
+    role?: string;
+    content?: string;
+    timestamp: number;
+    is_sidechain: number;
+    agent_id?: string;
+    request_id?: string;
+    git_branch?: string;
+    cwd?: string;
+    metadata: string;
+}
+export interface DecisionRow {
+    id: string;
+    conversation_id: string;
+    message_id: string;
+    decision_text: string;
+    rationale?: string;
+    alternatives_considered: string;
+    rejected_reasons: string;
+    context?: string;
+    related_files: string;
+    related_commits: string;
+    timestamp: number;
+}
+export interface MistakeRow {
+    id: string;
+    conversation_id: string;
+    message_id: string;
+    mistake_type: string;
+    what_went_wrong: string;
+    correction?: string;
+    user_correction_message?: string;
+    files_affected: string;
+    timestamp: number;
+}
+export interface GitCommitRow {
+    hash: string;
+    message: string;
+    author?: string;
+    timestamp: number;
+    branch?: string;
+    files_changed: string;
+    conversation_id?: string;
+    related_message_id?: string;
+    metadata: string;
+}
+export interface RequirementRow {
+    id: string;
+    type: string;
+    description: string;
+    rationale?: string;
+    affects_components: string;
+    conversation_id: string;
+    message_id: string;
+    timestamp: number;
+}
+export interface ToolUseRow {
+    id: string;
+    message_id: string;
+    tool_name: string;
+    tool_input: string;
+    timestamp: number;
+    result_content?: string;
+    is_error: number;
+    stdout?: string;
+    stderr?: string;
+}
+//# sourceMappingURL=ToolTypes.d.ts.map

package/dist/types/ToolTypes.d.ts.map

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

package/dist/types/ToolTypes.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for MCP Tool arguments and responses
+ * Replaces 'any' types with proper interfaces for type safety
+ */
+export {};
+//# sourceMappingURL=ToolTypes.js.map

package/dist/types/ToolTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolTypes.js","sourceRoot":"","sources":["../../src/types/ToolTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/sanitization.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Input sanitization utilities for SQL LIKE queries and path validation
+ */
+/**
+ * Sanitize string for use in SQL LIKE patterns
+ * Escapes special LIKE characters: %, _, "
+ */
+export declare function sanitizeForLike(input: string): string;
+/**
+ * Validate and sanitize file path
+ * Cross-platform: prevents path traversal attacks and blocks system directories
+ */
+export declare function validateFilePath(filePath: string): string;
+/**
+ * Validate and normalize project path
+ * Cross-platform: handles both Unix (/) and Windows (\) paths
+ * Used for converting file paths to Claude project directory names
+ */
+export declare function sanitizeProjectPath(path: string): string;
+/**
+ * Sanitize SQL identifier (table/column name)
+ * Only allows alphanumeric and underscore
+ */
+export declare function sanitizeSQLIdentifier(identifier: string): string;
+/**
+ * Convert a project path to Claude Code's project folder name
+ * Cross-platform compatible - handles both Unix and Windows paths
+ *
+ * Examples:
+ * - macOS/Linux: /Users/joker/github/project → -Users-joker-github-project
+ * - Windows: C:\Users\user\project → C-Users-user-project
+ * - Windows UNC: \\server\share\project → -server-share-project
+ */
+export declare function pathToProjectFolderName(projectPath: string): string;
+//# sourceMappingURL=sanitization.d.ts.map

package/dist/utils/sanitization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitization.d.ts","sourceRoot":"","sources":["../../src/utils/sanitization.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiCzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAWnE"}

package/dist/utils/sanitization.js

@@ -0,0 +1,97 @@
+/**
+ * Input sanitization utilities for SQL LIKE queries and path validation
+ */
+import { normalize, sep } from 'path';
+/**
+ * Sanitize string for use in SQL LIKE patterns
+ * Escapes special LIKE characters: %, _, "
+ */
+export function sanitizeForLike(input) {
+    return input.replace(/[%_"\\]/g, '\\$&');
+}
+/**
+ * Validate and sanitize file path
+ * Cross-platform: prevents path traversal attacks and blocks system directories
+ */
+export function validateFilePath(filePath) {
+    // Remove any null bytes
+    const cleaned = filePath.replace(/\0/g, '');
+    // Check for path traversal attempts
+    if (cleaned.includes('..')) {
+        throw new Error('Path traversal detected: .. is not allowed in file paths');
+    }
+    // Check for absolute paths outside allowed directories (platform-specific)
+    const isWindows = process.platform === 'win32';
+    if (isWindows) {
+        // Windows system directories (case-insensitive)
+        const forbidden = [
+            /^[A-Z]:\\Windows\\/i,
+            /^[A-Z]:\\Program Files/i,
+            /^[A-Z]:\\ProgramData/i,
+            /^[A-Z]:\\System/i,
+        ];
+        if (forbidden.some(pattern => pattern.test(cleaned))) {
+            throw new Error('Access to system directories is not allowed');
+        }
+    }
+    else {
+        // Unix system directories
+        if (cleaned.startsWith('/etc') ||
+            cleaned.startsWith('/sys') ||
+            cleaned.startsWith('/proc')) {
+            throw new Error('Access to system directories is not allowed');
+        }
+    }
+    return cleaned;
+}
+/**
+ * Validate and normalize project path
+ * Cross-platform: handles both Unix (/) and Windows (\) paths
+ * Used for converting file paths to Claude project directory names
+ */
+export function sanitizeProjectPath(path) {
+    // Remove null bytes
+    const cleaned = path.replace(/\0/g, '');
+    // Check for path traversal
+    if (cleaned.includes('..')) {
+        throw new Error('Path traversal detected in project path');
+    }
+    // First normalize with Node's native path module for current platform
+    let normalized = normalize(cleaned);
+    // Then handle any remaining separators from other platforms
+    // Replace multiple consecutive slashes/backslashes with single separator
+    normalized = normalized.replace(/[\\/]+/g, sep);
+    // Remove trailing path separator
+    const trailingSepRegex = new RegExp(`${sep.replace(/\\/g, '\\\\')}+$`);
+    return normalized.replace(trailingSepRegex, '');
+}
+/**
+ * Sanitize SQL identifier (table/column name)
+ * Only allows alphanumeric and underscore
+ */
+export function sanitizeSQLIdentifier(identifier) {
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(identifier)) {
+        throw new Error(`Invalid SQL identifier: ${identifier}`);
+    }
+    return identifier;
+}
+/**
+ * Convert a project path to Claude Code's project folder name
+ * Cross-platform compatible - handles both Unix and Windows paths
+ *
+ * Examples:
+ * - macOS/Linux: /Users/joker/github/project → -Users-joker-github-project
+ * - Windows: C:\Users\user\project → C-Users-user-project
+ * - Windows UNC: \\server\share\project → -server-share-project
+ */
+export function pathToProjectFolderName(projectPath) {
+    // Normalize the path first
+    const normalized = sanitizeProjectPath(projectPath);
+    // Replace Windows drive letters (C: → C, D: → D)
+    // Replace both forward and backward slashes with dashes
+    const folderName = normalized
+        .replace(/^([A-Z]):/i, '$1') // Remove colon from drive letter
+        .replace(/[\\/]+/g, '-'); // Replace / or \ with -
+    return folderName;
+}
+//# sourceMappingURL=sanitization.js.map

package/dist/utils/sanitization.js.map

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

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "claude-conversation-memory-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for indexing and searching Claude Code conversation history with decision tracking and git integration",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "claude-conversation-memory-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && npm run postbuild",
+    "postbuild": "cp src/storage/schema.sql dist/storage/",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "docs": "typedoc --out docs src",
+    "test:watch": "npm test -- --watch",
+    "test:coverage": "npm test -- --coverage",
+    "pre-push": "npm run type-check && npm run lint && npm run build",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "conversation",
+    "memory",
+    "semantic-search",
+    "decision-tracking"
+  ],
+  "author": "xiaolai",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xiaolai/claude-conversation-memory-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xiaolai/claude-conversation-memory-mcp/issues"
+  },
+  "homepage": "https://github.com/xiaolai/claude-conversation-memory-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "better-sqlite3": "^11.10.0",
+    "lru-cache": "^10.0.0",
+    "nanoid": "^5.0.0",
+    "simple-git": "^3.25.0",
+    "sqlite-vec": "^0.1.6"
+  },
+  "optionalDependencies": {
+    "@xenova/transformers": "^2.17.2",
+    "openai": "^4.77.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.5",
+    "@typescript-eslint/eslint-plugin": "^8.19.1",
+    "@typescript-eslint/parser": "^8.19.1",
+    "eslint": "^9.18.0",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "lint-staged": "^16.2.6",
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  }
+}