lance-context 0.1.0

package/README.md

@@ -0,0 +1,139 @@
+# lance-context
+
+An MCP plugin that adds semantic code search to Claude Code and other AI coding agents, giving them deep context from your entire codebase.
+
+## Features
+
+- **Semantic Code Search**: Natural language queries locate relevant code across your entire codebase
+- **Multiple Embedding Backends**: Jina v3 API, local sentence-transformers, or Ollama
+- **LanceDB Vector Storage**: Fast, efficient vector search with hybrid BM25 + dense matching
+- **MCP Compatible**: Works with Claude Code, Cursor, and other MCP-compatible tools
+
+## Installation
+
+### For Claude Code
+
+```bash
+claude mcp add lance-context -- npx lance-context
+```
+
+Or with a specific project path:
+
+```bash
+claude mcp add lance-context -- npx lance-context --project /path/to/your/project
+```
+
+### Manual Installation
+
+```bash
+npm install -g lance-context
+```
+
+## Configuration
+
+### Embedding Backends
+
+lance-context automatically selects the best available backend:
+
+1. **Jina v3** (highest quality, free tier available)
+   ```bash
+   export JINA_API_KEY=your-api-key
+   ```
+
+2. **Ollama** (local, privacy-preserving)
+   ```bash
+   # Make sure Ollama is running with nomic-embed-text
+   ollama pull nomic-embed-text
+   ```
+
+## Usage
+
+Once installed, you'll have access to these tools:
+
+### `index_codebase`
+
+Index your codebase for semantic search:
+
+```
+> index_codebase
+Indexed 150 files, created 800 chunks.
+```
+
+With custom patterns:
+
+```
+> index_codebase(patterns: ["**/*.py"], excludePatterns: ["**/tests/**"])
+```
+
+### `search_code`
+
+Search using natural language:
+
+```
+> search_code(query: "authentication middleware")
+
+## Result 1: src/middleware/auth.ts:1-50
+...
+```
+
+### `get_index_status`
+
+Check index status:
+
+```
+> get_index_status
+{
+  "indexed": true,
+  "fileCount": 150,
+  "chunkCount": 800,
+  "lastUpdated": "2024-12-27T12:00:00Z"
+}
+```
+
+### `clear_index`
+
+Clear the index:
+
+```
+> clear_index
+Index cleared.
+```
+
+## How It Works
+
+1. **Indexing**: Code files are chunked into ~100-line segments with overlap
+2. **Embedding**: Each chunk is converted to a vector using your chosen backend
+3. **Storage**: Vectors are stored in LanceDB (`.lance-context/` directory)
+4. **Search**: Natural language queries are embedded and matched against stored vectors
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `JINA_API_KEY` | Jina AI API key for embeddings | - |
+| `OLLAMA_URL` | Ollama server URL | `http://localhost:11434` |
+| `LANCE_CONTEXT_PROJECT` | Project path to index | Current directory |
+
+## Supported Languages
+
+TypeScript, JavaScript, Python, Go, Rust, Java, Ruby, PHP, C/C++, C#, Swift, Kotlin, and more.
+
+## License
+
+GPL-3.0 - See [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions welcome! Please read our contributing guidelines before submitting PRs.
+
+## Related Projects
+
+- [claude-context](https://github.com/zilliztech/claude-context) - Similar tool using Zilliz Cloud
+- [Serena](https://github.com/oraios/serena) - Symbol-level code navigation
+
+## Credits
+
+Built with:
+- [LanceDB](https://lancedb.github.io/lancedb/) - Vector database
+- [MCP SDK](https://github.com/modelcontextprotocol/sdk) - Model Context Protocol
+- [Jina AI](https://jina.ai/) - Embedding API

package/dist/embeddings/index.d.ts

@@ -0,0 +1,10 @@
+import type { EmbeddingBackend, EmbeddingConfig } from './types.js';
+export * from './types.js';
+export { OllamaBackend } from './ollama.js';
+export { JinaBackend } from './jina.js';
+/**
+ * Create an embedding backend based on configuration
+ * Falls back through backends: jina -> local -> ollama
+ */
+export declare function createEmbeddingBackend(config?: Partial<EmbeddingConfig>): Promise<EmbeddingBackend>;
+//# sourceMappingURL=index.d.ts.map

package/dist/embeddings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIpE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAgC3B"}

package/dist/embeddings/index.js

@@ -0,0 +1,37 @@
+import { OllamaBackend } from './ollama.js';
+import { JinaBackend } from './jina.js';
+export * from './types.js';
+export { OllamaBackend } from './ollama.js';
+export { JinaBackend } from './jina.js';
+/**
+ * Create an embedding backend based on configuration
+ * Falls back through backends: jina -> local -> ollama
+ */
+export async function createEmbeddingBackend(config) {
+    const backends = [];
+    // Priority 1: Jina (if API key available)
+    const jinaKey = config?.apiKey || process.env.JINA_API_KEY;
+    if (jinaKey) {
+        backends.push(() => new JinaBackend({ backend: 'jina', apiKey: jinaKey, ...config }));
+    }
+    // Priority 2: Ollama (local fallback)
+    backends.push(() => new OllamaBackend({
+        backend: 'ollama',
+        baseUrl: config?.baseUrl || process.env.OLLAMA_URL || 'http://localhost:11434',
+        model: config?.model || 'nomic-embed-text',
+    }));
+    // Try each backend until one works
+    for (const createBackend of backends) {
+        try {
+            const backend = createBackend();
+            await backend.initialize();
+            console.error(`[lance-context] Using ${backend.name} embedding backend`);
+            return backend;
+        }
+        catch (error) {
+            console.error(`[lance-context] Backend failed: ${error}`);
+        }
+    }
+    throw new Error('No embedding backend available. Install Ollama or set JINA_API_KEY.');
+}
+//# sourceMappingURL=index.js.map

package/dist/embeddings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAiC;IAEjC,MAAM,QAAQ,GAAkC,EAAE,CAAC;IAEnD,0CAA0C;IAC1C,MAAM,OAAO,GAAG,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC3D,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,sCAAsC;IACtC,QAAQ,CAAC,IAAI,CACX,GAAG,EAAE,CACH,IAAI,aAAa,CAAC;QAChB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,wBAAwB;QAC9E,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,kBAAkB;KAC3C,CAAC,CACL,CAAC;IAEF,mCAAmC;IACnC,KAAK,MAAM,aAAa,IAAI,QAAQ,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;YAChC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,yBAAyB,OAAO,CAAC,IAAI,oBAAoB,CAAC,CAAC;YACzE,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;AACzF,CAAC"}

package/dist/embeddings/jina.d.ts

@@ -0,0 +1,18 @@
+import type { EmbeddingBackend, EmbeddingConfig } from './types.js';
+/**
+ * Jina AI embedding backend
+ * Uses Jina's free API tier for high-quality embeddings
+ */
+export declare class JinaBackend implements EmbeddingBackend {
+    name: string;
+    private model;
+    private apiKey;
+    private baseUrl;
+    private dimensions;
+    constructor(config: EmbeddingConfig);
+    initialize(): Promise<void>;
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    getDimensions(): number;
+}
+//# sourceMappingURL=jina.d.ts.map

package/dist/embeddings/jina.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jina.d.ts","sourceRoot":"","sources":["../../src/embeddings/jina.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE;;;GAGG;AACH,qBAAa,WAAY,YAAW,gBAAgB;IAClD,IAAI,SAAU;IACd,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,UAAU,CAAQ;gBAEd,MAAM,EAAE,eAAe;IAQ7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsBtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAsBtD,aAAa,IAAI,MAAM;CAGxB"}

package/dist/embeddings/jina.js

@@ -0,0 +1,69 @@
+/**
+ * Jina AI embedding backend
+ * Uses Jina's free API tier for high-quality embeddings
+ */
+export class JinaBackend {
+    name = 'jina';
+    model;
+    apiKey;
+    baseUrl = 'https://api.jina.ai/v1/embeddings';
+    dimensions = 1024; // jina-embeddings-v3 default
+    constructor(config) {
+        this.model = config.model || 'jina-embeddings-v3';
+        if (!config.apiKey) {
+            throw new Error('Jina API key is required. Set JINA_API_KEY environment variable.');
+        }
+        this.apiKey = config.apiKey;
+    }
+    async initialize() {
+        // Test API key with a small request
+        try {
+            await this.embed('test');
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize Jina backend: ${error}`);
+        }
+    }
+    async embed(text) {
+        const response = await fetch(this.baseUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.model,
+                input: [text],
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Jina API error: ${response.status} - ${error}`);
+        }
+        const data = (await response.json());
+        return data.data[0].embedding;
+    }
+    async embedBatch(texts) {
+        const response = await fetch(this.baseUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.model,
+                input: texts,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Jina API error: ${response.status} - ${error}`);
+        }
+        const data = (await response.json());
+        return data.data.map((d) => d.embedding);
+    }
+    getDimensions() {
+        return this.dimensions;
+    }
+}
+//# sourceMappingURL=jina.js.map

package/dist/embeddings/jina.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jina.js","sourceRoot":"","sources":["../../src/embeddings/jina.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACtB,IAAI,GAAG,MAAM,CAAC;IACN,KAAK,CAAS;IACd,MAAM,CAAS;IACf,OAAO,GAAG,mCAAmC,CAAC;IAC9C,UAAU,GAAG,IAAI,CAAC,CAAC,6BAA6B;IAExD,YAAY,MAAuB;QACjC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,oBAAoB,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU;QACd,oCAAoC;QACpC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;YACzC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,CAAC,IAAI,CAAC;aACd,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,MAAM,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6C,CAAC;QACjF,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;YACzC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,KAAK;aACb,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,MAAM,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6C,CAAC;QACjF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/embeddings/ollama.d.ts

@@ -0,0 +1,17 @@
+import type { EmbeddingBackend, EmbeddingConfig } from './types.js';
+/**
+ * Ollama embedding backend
+ * Uses local Ollama server for embeddings
+ */
+export declare class OllamaBackend implements EmbeddingBackend {
+    name: string;
+    private model;
+    private baseUrl;
+    private dimensions;
+    constructor(config: EmbeddingConfig);
+    initialize(): Promise<void>;
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    getDimensions(): number;
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/embeddings/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/embeddings/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE;;;GAGG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IACpD,IAAI,SAAY;IAChB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAO;gBAEb,MAAM,EAAE,eAAe;IAK7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAMtD,aAAa,IAAI,MAAM;CAGxB"}

package/dist/embeddings/ollama.js

@@ -0,0 +1,50 @@
+/**
+ * Ollama embedding backend
+ * Uses local Ollama server for embeddings
+ */
+export class OllamaBackend {
+    name = 'ollama';
+    model;
+    baseUrl;
+    dimensions = 768; // nomic-embed-text default
+    constructor(config) {
+        this.model = config.model || 'nomic-embed-text';
+        this.baseUrl = config.baseUrl || 'http://localhost:11434';
+    }
+    async initialize() {
+        // Test connection
+        try {
+            const response = await fetch(`${this.baseUrl}/api/tags`);
+            if (!response.ok) {
+                throw new Error(`Ollama server returned ${response.status}`);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to Ollama at ${this.baseUrl}: ${error}`);
+        }
+    }
+    async embed(text) {
+        const response = await fetch(`${this.baseUrl}/api/embeddings`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: this.model,
+                prompt: text,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Ollama embedding failed: ${response.status}`);
+        }
+        const data = (await response.json());
+        return data.embedding;
+    }
+    async embedBatch(texts) {
+        // Ollama doesn't have native batch, so we parallelize
+        const embeddings = await Promise.all(texts.map((t) => this.embed(t)));
+        return embeddings;
+    }
+    getDimensions() {
+        return this.dimensions;
+    }
+}
+//# sourceMappingURL=ollama.js.map

package/dist/embeddings/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../src/embeddings/ollama.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,aAAa;IACxB,IAAI,GAAG,QAAQ,CAAC;IACR,KAAK,CAAS;IACd,OAAO,CAAS;IAChB,UAAU,GAAG,GAAG,CAAC,CAAC,2BAA2B;IAErD,YAAY,MAAuB;QACjC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,kBAAkB,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,wBAAwB,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,UAAU;QACd,kBAAkB;QAClB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;YACzD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,iBAAiB,EAAE;YAC7D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI;aACb,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;QAChE,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,sDAAsD;QACtD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/embeddings/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Embedding backend interface
+ */
+export interface EmbeddingBackend {
+    name: string;
+    initialize(): Promise<void>;
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    getDimensions(): number;
+}
+export interface EmbeddingConfig {
+    backend: 'jina' | 'local' | 'ollama';
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+}
+export declare const DEFAULT_CONFIG: EmbeddingConfig;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjD,aAAa,IAAI,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,eAI5B,CAAC"}

package/dist/embeddings/types.js

@@ -0,0 +1,6 @@
+export const DEFAULT_CONFIG = {
+    backend: 'ollama',
+    model: 'nomic-embed-text',
+    baseUrl: 'http://localhost:11434',
+};
+//# sourceMappingURL=types.js.map

package/dist/embeddings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,wBAAwB;CAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+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 { createEmbeddingBackend } from './embeddings/index.js';
+import { CodeIndexer } from './search/indexer.js';
+const PROJECT_PATH = process.env.LANCE_CONTEXT_PROJECT || process.cwd();
+let indexer = null;
+async function getIndexer() {
+    if (!indexer) {
+        const backend = await createEmbeddingBackend();
+        indexer = new CodeIndexer(PROJECT_PATH, backend);
+        await indexer.initialize();
+    }
+    return indexer;
+}
+const server = new Server({
+    name: 'lance-context',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'index_codebase',
+                description: 'Index the codebase for semantic search. Creates vector embeddings of all code files.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        patterns: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Glob patterns for files to index (default: common code files)',
+                        },
+                        excludePatterns: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Glob patterns for files to exclude (default: node_modules, dist, .git)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'search_code',
+                description: 'Search the codebase using natural language. Returns relevant code snippets.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Natural language query to search for',
+                        },
+                        limit: {
+                            type: 'number',
+                            description: 'Maximum number of results (default: 10)',
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'get_index_status',
+                description: 'Get the current status of the code index.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'clear_index',
+                description: 'Clear the code index.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        const idx = await getIndexer();
+        switch (name) {
+            case 'index_codebase': {
+                const patterns = args?.patterns || undefined;
+                const excludePatterns = args?.excludePatterns || undefined;
+                const result = await idx.indexCodebase(patterns, excludePatterns);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Indexed ${result.filesIndexed} files, created ${result.chunksCreated} chunks.`,
+                        },
+                    ],
+                };
+            }
+            case 'search_code': {
+                const query = args?.query;
+                const limit = args?.limit || 10;
+                const results = await idx.search(query, limit);
+                const formatted = results
+                    .map((r, i) => `## Result ${i + 1}: ${r.filePath}:${r.startLine}-${r.endLine}\n\`\`\`${r.language}\n${r.content}\n\`\`\``)
+                    .join('\n\n');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: formatted || 'No results found.',
+                        },
+                    ],
+                };
+            }
+            case 'get_index_status': {
+                const status = await idx.getStatus();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(status, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'clear_index': {
+                await idx.clearIndex();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Index cleared.',
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[lance-context] MCP server started');
+}
+main().catch((error) => {
+    console.error('[lance-context] Fatal error:', error);
+    process.exit(1);
+});
+//# 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/search/indexer.d.ts

@@ -0,0 +1,39 @@
+import type { EmbeddingBackend } from '../embeddings/index.js';
+export interface CodeChunk {
+    id: string;
+    filePath: string;
+    content: string;
+    startLine: number;
+    endLine: number;
+    language: string;
+    embedding?: number[];
+}
+export interface IndexStatus {
+    indexed: boolean;
+    fileCount: number;
+    chunkCount: number;
+    lastUpdated: string | null;
+    indexPath: string;
+}
+/**
+ * Code indexer using LanceDB for vector storage
+ */
+export declare class CodeIndexer {
+    private db;
+    private table;
+    private embeddingBackend;
+    private indexPath;
+    private projectPath;
+    constructor(projectPath: string, embeddingBackend: EmbeddingBackend);
+    initialize(): Promise<void>;
+    getStatus(): Promise<IndexStatus>;
+    indexCodebase(patterns?: string[], excludePatterns?: string[]): Promise<{
+        filesIndexed: number;
+        chunksCreated: number;
+    }>;
+    private chunkFile;
+    private getLanguage;
+    search(query: string, limit?: number): Promise<CodeChunk[]>;
+    clearIndex(): Promise<void>;
+}
+//# sourceMappingURL=indexer.d.ts.map

package/dist/search/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/search/indexer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB;IAM7D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;IA0BjC,aAAa,CACjB,QAAQ,GAAE,MAAM,EAAoF,EACpG,eAAe,GAAE,MAAM,EAAsE,GAC5F,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;YA+D7C,SAAS;IA2BvB,OAAO,CAAC,WAAW;IA2Bb,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAsB/D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAOlC"}