@splicr/mcp-server 0.1.0

package/dist/tools/search-knowledge.js

@@ -0,0 +1,160 @@
+import { getSupabase, geminiApiKey } from '../lib/supabase.js';
+import { detectProject } from '../lib/project-detector.js';
+export const searchKnowledgeSchema = {
+    name: 'search_knowledge',
+    description: `Search the user's personal knowledge base powered by Splicr. The user saves articles, tweets, code snippets, and insights from across the web — use this tool to find relevant context when answering their questions.
+
+IMPORTANT: You MUST call this tool BEFORE answering whenever:
+- The user asks about a technology, tool, pattern, concept, or opinion ("what do you think about X", "how does X work", "should I use X")
+- The user is making a technical decision or comparing approaches
+- The user references something they read, saved, or shared before
+- The topic could plausibly have saved context (articles, threads, bookmarks)
+
+Always search Splicr first, then supplement with your own knowledge. The user's saved context should ground your answer — do not skip this tool and rely solely on your training data.
+
+The search is semantic — describe what you're looking for in natural language.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'Natural language search query — describe what context would be helpful' },
+            project: { type: 'string', description: 'Scope to a specific project name, or "auto" to detect from cwd. Omit to search all projects.' },
+            limit: { type: 'number', description: 'Max results (default: 5)' },
+        },
+        required: ['query'],
+    },
+};
+async function generateEmbedding(text) {
+    if (!geminiApiKey) {
+        throw new Error('GEMINI_API_KEY is not configured. Set it in ~/.splicr/config.json or environment.');
+    }
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-embedding-001:embedContent';
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-goog-api-key': geminiApiKey,
+                },
+                signal: AbortSignal.timeout(10000),
+                body: JSON.stringify({
+                    model: 'models/gemini-embedding-001',
+                    content: { parts: [{ text }] },
+                    outputDimensionality: 768,
+                }),
+            });
+            if (!response.ok) {
+                const errText = await response.text();
+                if (attempt === 0 && (response.status === 429 || response.status >= 500)) {
+                    await new Promise(r => setTimeout(r, 1000));
+                    continue;
+                }
+                throw new Error(`Gemini embedding failed (${response.status}): ${errText}`);
+            }
+            const result = await response.json();
+            return result.embedding.values;
+        }
+        catch (err) {
+            if (attempt === 0) {
+                await new Promise(r => setTimeout(r, 1000));
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw new Error('Gemini embedding failed after retries');
+}
+function formatAge(dateStr) {
+    const date = new Date(dateStr);
+    if (isNaN(date.getTime()))
+        return 'unknown';
+    const days = Math.floor((Date.now() - date.getTime()) / 86400000);
+    if (days < 0)
+        return 'just now';
+    if (days === 0)
+        return 'today';
+    if (days === 1)
+        return 'yesterday';
+    if (days < 7)
+        return `${days}d ago`;
+    if (days < 30)
+        return `${Math.floor(days / 7)}w ago`;
+    if (days < 365)
+        return `${Math.floor(days / 30)}mo ago`;
+    return `${Math.floor(days / 365)}y ago`;
+}
+export async function handleSearchKnowledge(args) {
+    const { supabase, userId } = await getSupabase();
+    const query = String(args.query || '').trim();
+    if (!query)
+        return 'Please provide a search query.';
+    if (query.length > 1000)
+        return 'Query too long (max 1000 chars).';
+    const limit = Math.min(Math.max(1, Number(args.limit) || 5), 50);
+    const projectArg = args.project;
+    // Resolve project
+    let projectId;
+    if (projectArg === 'auto') {
+        const detected = await detectProject(process.cwd());
+        projectId = detected?.id;
+    }
+    else if (projectArg) {
+        const { data, error: lookupError } = await supabase
+            .from('projects')
+            .select('id')
+            .eq('user_id', userId)
+            .ilike('name', projectArg)
+            .limit(1);
+        if (lookupError) {
+            return `Error looking up project: ${lookupError.message}`;
+        }
+        projectId = data?.[0]?.id;
+        if (!projectId) {
+            return `Project "${projectArg}" not found. Check the name and try again.`;
+        }
+    }
+    // Generate embedding for query
+    const queryEmbedding = await generateEmbedding(query);
+    // Hybrid search: vector + full-text + RRF + boost signals
+    const { data, error } = await supabase.rpc('hybrid_search_captures', {
+        query_text: query,
+        query_embedding: queryEmbedding,
+        match_user_id: userId,
+        match_project_id: projectId || null,
+        match_limit: limit,
+        match_threshold: 0.2,
+    });
+    if (error) {
+        // Fallback to legacy vector-only search if hybrid isn't available yet
+        const { data: fallbackData, error: fallbackError } = await supabase.rpc('search_captures', {
+            query_embedding: queryEmbedding,
+            match_user_id: userId,
+            match_project_id: projectId || null,
+            match_limit: limit,
+            match_threshold: 0.3,
+        });
+        if (fallbackError)
+            return `Error searching: ${fallbackError.message}`;
+        if (!fallbackData || fallbackData.length === 0)
+            return 'No relevant knowledge found in Splicr.';
+        const results = fallbackData.map((r, i) => {
+            const age = formatAge(r.created_at);
+            const score = r.similarity ? `${(r.similarity * 100).toFixed(0)}%` : 'n/a';
+            return `${i + 1}. **${r.title || 'Untitled'}**\n` +
+                `   ${r.insight}\n` +
+                `   source: ${r.source_type || 'unknown'} | saved: ${age} | match: ${score} | tags: ${r.tags?.join(', ') || 'none'}${r.source_url ? `\n   url: ${r.source_url}` : ''}`;
+        }).join('\n\n');
+        return `*From Splicr — ${fallbackData.length} result(s):*\n\n${results}`;
+    }
+    if (!data || data.length === 0)
+        return 'No relevant knowledge found in Splicr.';
+    const results = data.map((r, i) => {
+        const age = formatAge(r.created_at);
+        const score = r.rrf_score ? `${(r.rrf_score * 100).toFixed(0)}%` : 'n/a';
+        return `${i + 1}. **${r.title || 'Untitled'}**\n` +
+            `   ${r.insight}\n` +
+            `   source: ${r.source_type || 'unknown'} | saved: ${age} | match: ${score} | tags: ${r.tags?.join(', ') || 'none'}${r.source_url ? `\n   url: ${r.source_url}` : ''}`;
+    }).join('\n\n');
+    return `*From Splicr — ${data.length} result(s):*\n\n${results}`;
+}
+//# sourceMappingURL=search-knowledge.js.map

package/dist/tools/search-knowledge.js.map

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

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@splicr/mcp-server",
+  "version": "0.1.0",
+  "description": "Splicr MCP server — route what you read to what you're building",
+  "type": "module",
+  "bin": "./dist/cli.js",
+  "files": ["dist"],
+  "keywords": ["mcp", "splicr", "knowledge-base", "claude-code", "ai-agent"],
+  "repository": { "type": "git", "url": "https://github.com/c0ncepT23/Splicr.git", "directory": "packages/mcp-server" },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@google/generative-ai": "^0.24.1",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@supabase/supabase-js": "^2.45.0",
+    "openai": "^4.55.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.5.0"
+  }
+}