@vivantel/virage-mcp 0.1.2

package/README.md

@@ -0,0 +1,81 @@
+# @vivantel/virage-mcp
+
+[![npm](https://img.shields.io/npm/v/@vivantel/virage-mcp)](https://www.npmjs.com/package/@vivantel/virage-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP (Model Context Protocol) stdio server for [Virage RAG](https://github.com/vivantel/virage). Expose your indexed knowledge base to AI assistants — search and inspect chunks directly from Claude Desktop, Claude Code, or any MCP-compatible client.
+
+## Features
+
+- **search** — semantic vector search with similarity scores
+- **list_chunks** — browse indexed chunks, filter by source file
+- **get_chunk** — fetch a single chunk by content hash
+- **list_source_files** — see all indexed files with chunk counts
+- **get_stats** — index statistics (totals, embedding/upload status)
+
+All tools are **read-only** — the server never modifies your index.
+
+## Installation
+
+```bash
+npm install @vivantel/virage-mcp
+```
+
+## Usage
+
+Requires a `virage.config.json` in your project (generated by `virage init`).
+
+```bash
+virage-mcp --config ./virage.config.json
+```
+
+## Claude Desktop configuration
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "virage": {
+      "command": "npx",
+      "args": [
+        "@vivantel/virage-mcp",
+        "--config",
+        "/absolute/path/to/your/virage.config.json"
+      ]
+    }
+  }
+}
+```
+
+## Claude Code configuration
+
+Run inside your project:
+
+```bash
+claude mcp add virage -- npx @vivantel/virage-mcp --config ./virage.config.json
+```
+
+## Programmatic use
+
+```typescript
+import { createMcpServer } from "@vivantel/virage-mcp";
+import { loadConfig, EmbeddingsDb, defaultEmbeddingsDb } from "@vivantel/virage-core";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+const cfg = await loadConfig("./virage.config.json");
+const db = new EmbeddingsDb(defaultEmbeddingsDb());
+await cfg.vectorStore.initialize();
+
+const server = createMcpServer({ db, embedder: cfg.embedder, vectorStore: cfg.vectorStore });
+await server.connect(new StdioServerTransport());
+```
+
+## Requirements
+
+- Node.js ≥ 18
+- A configured Virage project with `virage.config.json` and a populated `.virage/embeddings.db`
+
+## License
+
+MIT © Vivantel

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig, EmbeddingsDb, defaultEmbeddingsDb, } from "@vivantel/virage-core";
+import { createMcpServer } from "./server.js";
+const configIdx = process.argv.indexOf("--config");
+if (configIdx === -1 || !process.argv[configIdx + 1]) {
+    process.stderr.write("Usage: virage-mcp --config <path-to-virage.config.json>\n");
+    process.exit(1);
+}
+const configPath = process.argv[configIdx + 1];
+const cfg = await loadConfig(configPath);
+const dbPath = cfg.options?.embeddingsFile?.replace(/\.json$/, ".db") ?? defaultEmbeddingsDb();
+const db = new EmbeddingsDb(dbPath);
+await cfg.vectorStore.initialize();
+const ctx = { db, embedder: cfg.embedder, vectorStore: cfg.vectorStore };
+const server = createMcpServer(ctx);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.on("SIGINT", () => {
+    db.close();
+    process.exit(0);
+});
+process.on("SIGTERM", () => {
+    db.close();
+    process.exit(0);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,UAAU,EACV,YAAY,EACZ,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACnD,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2DAA2D,CAC5D,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;AAE/C,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;AAEzC,MAAM,MAAM,GAER,GAAG,CAAC,OACL,EAAE,cAAc,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,mBAAmB,EAAE,CAAC;AAExE,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AACpC,MAAM,GAAG,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;AAEnC,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;AACzE,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;AACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createMcpServer } from "./server.js";
+export type { McpContext } from "./tools.js";
+//# 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":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createMcpServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

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

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

package/dist/index.test.js

@@ -0,0 +1,27 @@
+import { describe, it, expect } from "vitest";
+import { createMcpServer } from "./server.js";
+import { handleSearch, handleListChunks, handleGetChunk, handleListSourceFiles, handleGetStats, } from "./tools.js";
+describe("package exports", () => {
+    it("createMcpServer is a function", () => {
+        expect(typeof createMcpServer).toBe("function");
+    });
+    it("tool handlers are functions", () => {
+        expect(typeof handleSearch).toBe("function");
+        expect(typeof handleListChunks).toBe("function");
+        expect(typeof handleGetChunk).toBe("function");
+        expect(typeof handleListSourceFiles).toBe("function");
+        expect(typeof handleGetStats).toBe("function");
+    });
+});
+describe("createMcpServer", () => {
+    it("creates a server with registered tools", () => {
+        const ctx = {
+            db: {},
+            embedder: {},
+            vectorStore: {},
+        };
+        const server = createMcpServer(ctx);
+        expect(server).toBeDefined();
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG;YACV,EAAE,EAAE,EAAW;YACf,QAAQ,EAAE,EAAW;YACrB,WAAW,EAAE,EAAW;SACzB,CAAC;QACF,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpContext } from "./tools.js";
+export declare function createMcpServer(ctx: McpContext): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAS7C,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,CAwF1D"}

package/dist/server.js

@@ -0,0 +1,62 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { handleSearch, handleListChunks, handleGetChunk, handleListSourceFiles, handleGetStats, } from "./tools.js";
+export function createMcpServer(ctx) {
+    const server = new McpServer({ name: "virage-mcp", version: "0.1.0" });
+    server.tool("search", "Semantic vector search over the indexed documents. Returns top matching chunks with similarity scores.", {
+        query: z.string().describe("Search query text"),
+        top_k: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe("Number of results to return (default: 5)"),
+        collection: z
+            .string()
+            .optional()
+            .describe("Optional collection name to search within"),
+    }, async (args) => {
+        const results = await handleSearch(args, ctx);
+        return {
+            content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+        };
+    });
+    server.tool("list_chunks", "List indexed chunks, optionally filtered by source file.", {
+        source_file: z.string().optional().describe("Filter by source file path"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .optional()
+            .describe("Maximum number of chunks to return (default: 100)"),
+    }, async (args) => {
+        const results = await handleListChunks(args, ctx);
+        return {
+            content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+        };
+    });
+    server.tool("get_chunk", "Get a single chunk by its content hash.", {
+        content_hash: z.string().describe("16-character hex content hash"),
+    }, async (args) => {
+        const result = await handleGetChunk(args, ctx);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("list_source_files", "List all indexed source files with their chunk counts.", {}, async () => {
+        const results = await handleListSourceFiles({}, ctx);
+        return {
+            content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+        };
+    });
+    server.tool("get_stats", "Get index statistics: total chunks, embedding and upload status.", {}, async () => {
+        const result = await handleGetStats({}, ctx);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,43 @@
+import type { EmbeddingsDb, EmbeddingProvider, VectorStore } from "@vivantel/virage-core";
+export interface McpContext {
+    db: EmbeddingsDb;
+    embedder: EmbeddingProvider;
+    vectorStore: VectorStore;
+}
+export declare function handleSearch(args: {
+    query: string;
+    top_k?: number;
+    collection?: string;
+}, ctx: McpContext): Promise<{
+    id: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    similarity: number;
+    sourceFile: string;
+}[]>;
+export declare function handleListChunks(args: {
+    source_file?: string;
+    limit?: number;
+}, ctx: McpContext): Promise<{
+    contentHash: string | undefined;
+    sourceFile: string;
+    content: string;
+    metadata: Record<string, unknown>;
+}[]>;
+export declare function handleGetChunk(args: {
+    content_hash: string;
+}, ctx: McpContext): Promise<import("@vivantel/virage-core").Chunk>;
+export declare function handleListSourceFiles(_args: Record<string, never>, ctx: McpContext): Promise<{
+    sourceFile: string;
+    chunkCount: number;
+    commitHash: string | null;
+}[]>;
+export declare function handleGetStats(_args: Record<string, never>, ctx: McpContext): Promise<{
+    totalChunks: number;
+    embeddedCount: number;
+    uploadedCount: number;
+    pendingEmbedCount: number;
+    pendingUploadCount: number;
+    lastUpdated: number | null;
+}>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,YAAY,CAAC;IACjB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5D,GAAG,EAAE,UAAU;;;;;;KAehB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,GAAG,EAAE,UAAU;;;;;KAYhB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,EAC9B,GAAG,EAAE,UAAU,kDAOhB;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC5B,GAAG,EAAE,UAAU;;;;KAehB;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC5B,GAAG,EAAE,UAAU;;;;;;;GAkBhB"}

package/dist/tools.js

@@ -0,0 +1,61 @@
+export async function handleSearch(args, ctx) {
+    const embedding = await ctx.embedder.embed(args.query);
+    const results = await ctx.vectorStore.search(embedding, args.top_k ?? 5, args.collection);
+    return results.map((r) => ({
+        id: r.id,
+        content: r.content,
+        metadata: r.metadata,
+        similarity: r.similarity,
+        sourceFile: r.metadata["sourceFile"] ?? r.id,
+    }));
+}
+export async function handleListChunks(args, ctx) {
+    let chunks = ctx.db.getAllChunks();
+    if (args.source_file) {
+        chunks = chunks.filter((c) => c.sourceFile === args.source_file);
+    }
+    return chunks.slice(0, args.limit ?? 100).map((c) => ({
+        contentHash: c.contentHash,
+        sourceFile: c.sourceFile,
+        content: c.content.slice(0, 200),
+        metadata: c.metadata,
+    }));
+}
+export async function handleGetChunk(args, ctx) {
+    const chunk = ctx.db
+        .getAllChunks()
+        .find((c) => c.contentHash === args.content_hash);
+    if (!chunk)
+        throw new Error(`Chunk not found: ${args.content_hash}`);
+    return chunk;
+}
+export async function handleListSourceFiles(_args, ctx) {
+    const chunks = ctx.db.getAllChunks();
+    const fileStates = ctx.db.getFileStates();
+    const countMap = new Map();
+    for (const c of chunks) {
+        countMap.set(c.sourceFile, (countMap.get(c.sourceFile) ?? 0) + 1);
+    }
+    return Array.from(countMap.entries()).map(([sourceFile, chunkCount]) => ({
+        sourceFile,
+        chunkCount,
+        commitHash: fileStates.get(sourceFile) ?? null,
+    }));
+}
+export async function handleGetStats(_args, ctx) {
+    const allChunks = ctx.db.getAllChunks();
+    const embedded = ctx.db.getAll();
+    const pendingEmbedCount = ctx.db.getPendingEmbedChunks().length;
+    const pendingUploadCount = ctx.db.pendingCount();
+    const uploadedCount = allChunks.length - pendingEmbedCount - pendingUploadCount;
+    const meta = ctx.db.getMeta();
+    return {
+        totalChunks: allChunks.length,
+        embeddedCount: embedded.length,
+        uploadedCount: Math.max(0, uploadedCount),
+        pendingEmbedCount,
+        pendingUploadCount,
+        lastUpdated: meta?.updatedAt ?? null,
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@vivantel/virage-mcp",
+  "version": "0.1.2",
+  "type": "module",
+  "description": "MCP stdio server for Virage RAG — search and inspect your index from AI assistants",
+  "author": "Vivantel",
+  "license": "MIT",
+  "keywords": [
+    "rag",
+    "mcp",
+    "model-context-protocol",
+    "embeddings",
+    "search",
+    "virage"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vivantel/virage",
+    "directory": "packages/virage-mcp"
+  },
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "virage-mcp": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "fix": "npm run lint:fix && npm run format"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0",
+    "@vivantel/virage-core": "0.2.11"
+  },
+  "peerDependencies": {
+    "@vivantel/virage-core": "*"
+  },
+  "devDependencies": {
+    "@vivantel/virage-core": "0.2.11",
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  }
+}