cc-forever-mcp 1.0.0

package/dist/chunker.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Conversation chunker - Parse Human/Assistant pairs
+ */
+interface Chunk {
+    text: string;
+    question: string;
+}
+/**
+ * Parse conversation into Q&A pairs
+ */
+export declare function chunkConversation(content: string): Chunk[];
+export {};
+//# sourceMappingURL=chunker.d.ts.map

package/dist/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../src/chunker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAmD1D"}

package/dist/chunker.js

@@ -0,0 +1,53 @@
+/**
+ * Conversation chunker - Parse Human/Assistant pairs
+ */
+/**
+ * Parse conversation into Q&A pairs
+ */
+export function chunkConversation(content) {
+    const chunks = [];
+    const lines = content.split('\n');
+    let currentRole = null;
+    let currentContent = [];
+    let humanQuestion = '';
+    const rolePattern = /^(Human|User|Assistant|Claude):\s*/i;
+    for (const line of lines) {
+        const match = line.match(rolePattern);
+        if (match) {
+            const role = match[1].toLowerCase();
+            const newRole = role === 'human' || role === 'user' ? 'human' : 'assistant';
+            const textAfterRole = line.slice(match[0].length);
+            // Save previous content
+            if (currentRole === 'human' && currentContent.length > 0) {
+                humanQuestion = currentContent.join('\n').trim();
+            }
+            else if (currentRole === 'assistant' && humanQuestion && currentContent.length > 0) {
+                const answer = currentContent.join('\n').trim();
+                if (answer) {
+                    chunks.push({
+                        text: `Human: ${humanQuestion}\nAssistant: ${answer}`,
+                        question: humanQuestion.slice(0, 200),
+                    });
+                }
+                humanQuestion = '';
+            }
+            currentRole = newRole;
+            currentContent = textAfterRole ? [textAfterRole] : [];
+        }
+        else if (currentRole) {
+            currentContent.push(line);
+        }
+    }
+    // Handle last pair
+    if (currentRole === 'assistant' && humanQuestion && currentContent.length > 0) {
+        const answer = currentContent.join('\n').trim();
+        if (answer) {
+            chunks.push({
+                text: `Human: ${humanQuestion}\nAssistant: ${answer}`,
+                question: humanQuestion.slice(0, 200),
+            });
+        }
+    }
+    return chunks;
+}
+//# sourceMappingURL=chunker.js.map

package/dist/chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../src/chunker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,MAAM,GAAY,EAAE,CAAA;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAEjC,IAAI,WAAW,GAAiC,IAAI,CAAA;IACpD,IAAI,cAAc,GAAa,EAAE,CAAA;IACjC,IAAI,aAAa,GAAG,EAAE,CAAA;IAEtB,MAAM,WAAW,GAAG,qCAAqC,CAAA;IAEzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QAErC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;YACnC,MAAM,OAAO,GAAG,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAA;YAC3E,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;YAEjD,wBAAwB;YACxB,IAAI,WAAW,KAAK,OAAO,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;YAClD,CAAC;iBAAM,IAAI,WAAW,KAAK,WAAW,IAAI,aAAa,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrF,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;gBAC/C,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,UAAU,aAAa,gBAAgB,MAAM,EAAE;wBACrD,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;qBACtC,CAAC,CAAA;gBACJ,CAAC;gBACD,aAAa,GAAG,EAAE,CAAA;YACpB,CAAC;YAED,WAAW,GAAG,OAAO,CAAA;YACrB,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACvD,CAAC;aAAM,IAAI,WAAW,EAAE,CAAC;YACvB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,WAAW,KAAK,WAAW,IAAI,aAAa,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9E,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,UAAU,aAAa,gBAAgB,MAAM,EAAE;gBACrD,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aACtC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Configuration loader
+ */
+export interface Config {
+    embeddings?: {
+        path?: string;
+    };
+    data_dir?: string;
+    auto_index?: boolean;
+    source?: string;
+}
+/**
+ * Load config with priority:
+ * 1. Project-level: ./.forever/config.yml
+ * 2. User-level: ~/.forever/config.yml
+ * 3. Default settings
+ *
+ * data_dir is automatically set to the directory containing the config file
+ */
+export declare function loadConfig(): Config;
+/**
+ * Get data directory path
+ */
+export declare function getDataDir(config: Config): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,MAAM;IACrB,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,MAAM,CA6BnC;AA+CD;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CASjD"}

package/dist/config.js

@@ -0,0 +1,98 @@
+/**
+ * Configuration loader
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+/**
+ * Load config with priority:
+ * 1. Project-level: ./.forever/config.yml
+ * 2. User-level: ~/.forever/config.yml
+ * 3. Default settings
+ *
+ * data_dir is automatically set to the directory containing the config file
+ */
+export function loadConfig() {
+    // Priority 1: Project-level
+    const projectDir = path.join(process.cwd(), '.forever');
+    const projectConfig = path.join(projectDir, 'config.yml');
+    if (fs.existsSync(projectConfig)) {
+        return {
+            ...parseYaml(projectConfig),
+            data_dir: projectDir,
+            source: projectConfig,
+        };
+    }
+    // Priority 2: User-level
+    const userDir = path.join(os.homedir(), '.forever');
+    const userConfig = path.join(userDir, 'config.yml');
+    if (fs.existsSync(userConfig)) {
+        return {
+            ...parseYaml(userConfig),
+            data_dir: userDir,
+            source: userConfig,
+        };
+    }
+    // Priority 3: Default (user-level)
+    return {
+        embeddings: { path: 'Xenova/all-MiniLM-L6-v2' },
+        data_dir: path.join(os.homedir(), '.forever'),
+        source: 'default',
+    };
+}
+/**
+ * Simple YAML parser (handles basic key: value pairs)
+ */
+function parseYaml(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const config = {};
+    let currentSection = '';
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        // Check indentation for nested values
+        const indent = line.length - line.trimStart().length;
+        if (indent === 0 && trimmed.includes(':')) {
+            const [key, ...valueParts] = trimmed.split(':');
+            const value = valueParts.join(':').trim();
+            if (value) {
+                config[key.trim()] = parseValue(value);
+                currentSection = '';
+            }
+            else {
+                currentSection = key.trim();
+                config[currentSection] = {};
+            }
+        }
+        else if (indent > 0 && currentSection && trimmed.includes(':')) {
+            const [key, ...valueParts] = trimmed.split(':');
+            const value = valueParts.join(':').trim();
+            config[currentSection][key.trim()] = parseValue(value);
+        }
+    }
+    return config;
+}
+function parseValue(value) {
+    if (value.toLowerCase() === 'true')
+        return true;
+    if (value.toLowerCase() === 'false')
+        return false;
+    if (/^\d+$/.test(value))
+        return parseInt(value, 10);
+    if (/^\d+\.\d+$/.test(value))
+        return parseFloat(value);
+    return value.replace(/^["']|["']$/g, '');
+}
+/**
+ * Get data directory path
+ */
+export function getDataDir(config) {
+    const dir = config.data_dir || path.join(os.homedir(), '.forever');
+    const expanded = dir.startsWith('~') ? dir.replace('~', os.homedir()) : dir;
+    if (!fs.existsSync(expanded)) {
+        fs.mkdirSync(expanded, { recursive: true });
+    }
+    return expanded;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/embedder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Embedder implementation with Transformers.js
+ */
+export interface EmbedderConfig {
+    modelPath: string;
+    batchSize: number;
+    cacheDir: string;
+}
+export declare class Embedder {
+    private model;
+    private initPromise;
+    private readonly config;
+    constructor(config: EmbedderConfig);
+    initialize(): Promise<void>;
+    private ensureInitialized;
+    embed(text: string): Promise<number[]>;
+}
+//# sourceMappingURL=embedder.d.ts.map

package/dist/embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../src/embedder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAMD,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,MAAM,EAAE,cAAc;IAI5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAanB,iBAAiB;IAkBzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAoB7C"}

package/dist/embedder.js

@@ -0,0 +1,58 @@
+/**
+ * Embedder implementation with Transformers.js
+ */
+import { env, pipeline } from '@huggingface/transformers';
+// ============================================
+// Embedder Class
+// ============================================
+export class Embedder {
+    model = null;
+    initPromise = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async initialize() {
+        if (this.model)
+            return;
+        try {
+            env.cacheDir = this.config.cacheDir;
+            console.error(`Embedder: Loading model "${this.config.modelPath}"...`);
+            this.model = await pipeline('feature-extraction', this.config.modelPath);
+            console.error('Embedder: Model loaded successfully');
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize Embedder: ${error.message}`);
+        }
+    }
+    async ensureInitialized() {
+        if (this.model)
+            return;
+        if (this.initPromise) {
+            await this.initPromise;
+            return;
+        }
+        console.error('Embedder: First use detected. Loading model (may take 1-2 minutes on first run)...');
+        this.initPromise = this.initialize().catch((error) => {
+            this.initPromise = null;
+            throw error;
+        });
+        await this.initPromise;
+    }
+    async embed(text) {
+        await this.ensureInitialized();
+        if (text.length === 0) {
+            throw new Error('Cannot generate embedding for empty text');
+        }
+        try {
+            const options = { pooling: 'mean', normalize: true };
+            const modelCall = this.model;
+            const output = await modelCall(text, options);
+            return Array.from(output.data);
+        }
+        catch (error) {
+            throw new Error(`Failed to generate embedding: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=embedder.js.map

package/dist/embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../src/embedder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAYzD,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C;AAE/C,MAAM,OAAO,QAAQ;IACX,KAAK,GAAY,IAAI,CAAA;IACrB,WAAW,GAAyB,IAAI,CAAA;IAC/B,MAAM,CAAgB;IAEvC,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,KAAK;YAAE,OAAM;QAEtB,IAAI,CAAC;YACH,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAA;YACnC,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,CAAA;YACtE,IAAI,CAAC,KAAK,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;YACxE,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kCAAmC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAA;QAC/E,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,IAAI,CAAC,KAAK;YAAE,OAAM;QAEtB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAA;YACtB,OAAM;QACR,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,oFAAoF,CAAC,CAAA;QAEnG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACnD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;YACvB,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,WAAW,CAAA;IACxB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAA;QAE9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QAC7D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;YACpD,MAAM,SAAS,GAAG,IAAI,CAAC,KAGa,CAAA;YACpC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iCAAkC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC;CAEF"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * CC-Forever MCP Server
+ * Persistent conversation memory with semantic search
+ *
+ * Uses LanceDB + Transformers.js for lightweight local embeddings
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,300 @@
+#!/usr/bin/env node
+/**
+ * CC-Forever MCP Server
+ * Persistent conversation memory with semantic search
+ *
+ * Uses LanceDB + Transformers.js for lightweight local embeddings
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { VectorStore } from './vectorstore.js';
+import { Embedder } from './embedder.js';
+import { chunkConversation } from './chunker.js';
+import { loadConfig, getDataDir } from './config.js';
+// ============================================
+// Main Server
+// ============================================
+class CCForeverServer {
+    server;
+    vectorStore = null;
+    embedder = null;
+    config = null;
+    initialized = false;
+    constructor() {
+        this.server = new Server({ name: 'cc-forever-mcp', version: '1.0.0' }, { capabilities: { tools: {} } });
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // List tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                {
+                    name: 'store_memory',
+                    description: "Store Q&A conversation pairs in the memory index. Content MUST include both Human question AND Assistant answer. Example format: 'Human: How do I use OAuth?\\nAssistant: OAuth is an authentication protocol...'",
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            content: {
+                                type: 'string',
+                                description: "Conversation in 'Human: <question>\\nAssistant: <answer>' format. MUST include both Human and Assistant parts.",
+                            },
+                            project: {
+                                type: 'string',
+                                description: 'Project name (optional)',
+                            },
+                            tags: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Tags (optional)',
+                            },
+                            chunk: {
+                                type: 'boolean',
+                                description: 'Whether to chunk into Q&A pairs (default: true)',
+                                default: true,
+                            },
+                        },
+                        required: ['content'],
+                    },
+                },
+                {
+                    name: 'retrieve_memory',
+                    description: 'Search past conversations using semantic search',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            query: {
+                                type: 'string',
+                                description: 'Search query',
+                            },
+                            n_results: {
+                                type: 'integer',
+                                description: 'Number of results to return (default: 5)',
+                                default: 5,
+                            },
+                            threshold: {
+                                type: 'number',
+                                description: 'Similarity threshold 0-1 (default: 0.3)',
+                                default: 0.3,
+                            },
+                            project: {
+                                type: 'string',
+                                description: 'Filter by project name (optional)',
+                            },
+                        },
+                        required: ['query'],
+                    },
+                },
+                {
+                    name: 'get_stats',
+                    description: 'Get index statistics and configuration info',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {},
+                    },
+                },
+            ],
+        }));
+        // Call tool
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                // Lazy initialization
+                if (!this.initialized) {
+                    await this.initialize();
+                }
+                switch (name) {
+                    case 'store_memory':
+                        return await this.storeMemory(args);
+                    case 'retrieve_memory':
+                        return await this.retrieveMemory(args);
+                    case 'get_stats':
+                        return await this.getStats();
+                    default:
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify({ success: false, error: `Unknown tool: ${name}` }) }],
+                        };
+                }
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: `Tool execution failed: ${error.message}`,
+                            }),
+                        },
+                    ],
+                };
+            }
+        });
+    }
+    async initialize() {
+        this.config = loadConfig();
+        const dataDir = getDataDir(this.config);
+        const modelPath = this.config.embeddings?.path || 'Xenova/all-MiniLM-L6-v2';
+        const cacheDir = `${dataDir}/models`;
+        this.embedder = new Embedder({
+            modelPath,
+            batchSize: 8,
+            cacheDir,
+        });
+        // Download model on initialization
+        console.error('CC-Forever: Downloading embedding model (this may take a moment)...');
+        await this.embedder.initialize();
+        this.vectorStore = new VectorStore({
+            dbPath: `${dataDir}/lancedb`,
+            tableName: 'memories',
+        });
+        await this.vectorStore.initialize();
+        this.initialized = true;
+        console.error('CC-Forever MCP Server initialized');
+    }
+    async storeMemory(args) {
+        const { content, project, tags, chunk = true } = args;
+        // Validation
+        if (!content || !content.trim()) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: 'Content cannot be empty' }) }],
+            };
+        }
+        if (content.length > 100000) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: 'Content too large (max 100KB)' }) }],
+            };
+        }
+        const timestamp = new Date().toISOString();
+        const chunks = chunk ? chunkConversation(content) : [{ text: content, question: content.slice(0, 200) }];
+        if (chunks.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: "No valid Q&A pairs found in content. Format: 'Human: <question>\\nAssistant: <answer>'",
+                        }),
+                    },
+                ],
+            };
+        }
+        // Generate embeddings and store
+        const documents = [];
+        for (let i = 0; i < chunks.length; i++) {
+            const c = chunks[i];
+            const vector = await this.embedder.embed(c.text);
+            documents.push({
+                id: `${timestamp}-${i}`,
+                text: c.text,
+                question: c.question,
+                vector,
+                project: project || 'default',
+                tags: tags?.join(',') || 'conversation',
+                timestamp,
+            });
+        }
+        await this.vectorStore.insertChunks(documents);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        chunks_stored: chunks.length,
+                        timestamp,
+                    }),
+                },
+            ],
+        };
+    }
+    async retrieveMemory(args) {
+        let { query, n_results = 5, threshold = 0.3, project } = args;
+        // Validation
+        if (!query || !query.trim()) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: 'Query cannot be empty' }) }],
+            };
+        }
+        if (query.length > 10000) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: 'Query too long (max 10KB)' }) }],
+            };
+        }
+        // Sanitize
+        n_results = Math.min(Math.max(n_results, 1), 100);
+        threshold = Math.max(0, Math.min(threshold, 1));
+        const queryVector = await this.embedder.embed(query);
+        const results = await this.vectorStore.search(queryVector, n_results * 2);
+        // Filter and format
+        const formatted = results
+            .filter((r) => {
+            // Convert distance to similarity (1 - distance for dot product)
+            const similarity = 1 - r.score;
+            if (similarity < threshold)
+                return false;
+            if (project && r.project !== project)
+                return false;
+            return true;
+        })
+            .slice(0, n_results)
+            .map((r) => ({
+            score: Math.round((1 - r.score) * 10000) / 10000,
+            question: r.question,
+            text: r.text,
+            timestamp: r.timestamp,
+            project: r.project,
+            tags: r.tags,
+        }));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        results: formatted,
+                        query,
+                        total_found: formatted.length,
+                    }),
+                },
+            ],
+        };
+    }
+    async getStats() {
+        const status = await this.vectorStore.getStatus();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        total_chunks: status.chunkCount,
+                        model: this.config?.embeddings?.path || 'Xenova/all-MiniLM-L6-v2',
+                        data_dir: getDataDir(this.config),
+                        config_source: this.config?.source || 'default',
+                    }),
+                },
+            ],
+        };
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('CC-Forever MCP Server running on stdio');
+    }
+}
+// ============================================
+// Entry Point
+// ============================================
+async function main() {
+    try {
+        const server = new CCForeverServer();
+        await server.run();
+    }
+    catch (error) {
+        console.error('Failed to start CC-Forever MCP Server:', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/vectorstore.d.ts

@@ -0,0 +1,37 @@
+/**
+ * VectorStore implementation with LanceDB
+ */
+export interface VectorStoreConfig {
+    dbPath: string;
+    tableName: string;
+}
+export interface MemoryChunk {
+    id: string;
+    text: string;
+    question: string;
+    vector: number[];
+    project: string;
+    tags: string;
+    timestamp: string;
+}
+export interface SearchResult {
+    text: string;
+    question: string;
+    score: number;
+    project: string;
+    tags: string;
+    timestamp: string;
+}
+export declare class VectorStore {
+    private db;
+    private table;
+    private readonly config;
+    constructor(config: VectorStoreConfig);
+    initialize(): Promise<void>;
+    insertChunks(chunks: MemoryChunk[]): Promise<void>;
+    search(queryVector: number[], limit?: number): Promise<SearchResult[]>;
+    getStatus(): Promise<{
+        chunkCount: number;
+    }>;
+}
+//# sourceMappingURL=vectorstore.d.ts.map

package/dist/vectorstore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorstore.d.ts","sourceRoot":"","sources":["../src/vectorstore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,EAAE,iBAAiB;IAI/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBlD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyBlE,SAAS,IAAI,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAYnD"}

package/dist/vectorstore.js

@@ -0,0 +1,89 @@
+/**
+ * VectorStore implementation with LanceDB
+ */
+import { connect } from '@lancedb/lancedb';
+// ============================================
+// VectorStore Class
+// ============================================
+export class VectorStore {
+    db = null;
+    table = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async initialize() {
+        try {
+            this.db = await connect(this.config.dbPath);
+            const tableNames = await this.db.tableNames();
+            if (tableNames.includes(this.config.tableName)) {
+                this.table = await this.db.openTable(this.config.tableName);
+                console.error(`VectorStore: Opened existing table "${this.config.tableName}"`);
+            }
+            else {
+                console.error(`VectorStore: Table "${this.config.tableName}" will be created on first insertion`);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize VectorStore: ${error.message}`);
+        }
+    }
+    async insertChunks(chunks) {
+        if (chunks.length === 0)
+            return;
+        try {
+            if (!this.table) {
+                if (!this.db) {
+                    throw new Error('VectorStore is not initialized');
+                }
+                const records = chunks.map((chunk) => chunk);
+                this.table = await this.db.createTable(this.config.tableName, records);
+                console.error(`VectorStore: Created table "${this.config.tableName}"`);
+            }
+            else {
+                const records = chunks.map((chunk) => chunk);
+                await this.table.add(records);
+            }
+            console.error(`VectorStore: Inserted ${chunks.length} chunks`);
+        }
+        catch (error) {
+            throw new Error(`Failed to insert chunks: ${error.message}`);
+        }
+    }
+    async search(queryVector, limit = 10) {
+        if (!this.table) {
+            return [];
+        }
+        try {
+            const results = await this.table
+                .vectorSearch(queryVector)
+                .distanceType('dot')
+                .limit(limit)
+                .toArray();
+            return results.map((r) => ({
+                text: r.text,
+                question: r.question,
+                score: r._distance ?? 0,
+                project: r.project,
+                tags: r.tags,
+                timestamp: r.timestamp,
+            }));
+        }
+        catch (error) {
+            throw new Error(`Failed to search: ${error.message}`);
+        }
+    }
+    async getStatus() {
+        if (!this.table) {
+            return { chunkCount: 0 };
+        }
+        try {
+            const allRecords = await this.table.query().toArray();
+            return { chunkCount: allRecords.length };
+        }
+        catch (error) {
+            return { chunkCount: 0 };
+        }
+    }
+}
+//# sourceMappingURL=vectorstore.js.map

package/dist/vectorstore.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "cc-forever-mcp",
+  "version": "1.0.0",
+  "description": "CC-Forever MCP Server - Persistent conversation memory with semantic search",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "cc-forever-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^3.7.6",
+    "@lancedb/lancedb": "^0.22.2",
+    "@modelcontextprotocol/sdk": "^1.25.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}