gitnexus-mcp 0.1.0

package/dist/config/inject-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-config.js","sourceRoot":"","sources":["../../src/config/inject-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAuB/B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAQ,EAAE,UAAkB;IAChE,uCAAuC;IACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,qCAAqC;IACrC,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5B,MAAM,oBAAoB,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IAED,4EAA4E;IAC5E,IAAI,MAAM,GAAsB,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAEnD,kCAAkC;IAClC,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IAE5C,wCAAwC;IACxC,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG;QAC3B,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,CAAC,OAAO,CAAC;KAChB,CAAC;IAEF,uBAAuB;IACvB,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,UAAkB,EAAE,UAAkB;IACxE,IAAI,MAAM,GAAmB,EAAE,CAAC;IAEhC,kCAAkC;IAClC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IAE9B,4CAA4C;IAC5C,MAAM,CAAC,GAAG,CAAC,QAAQ,GAAG;QACpB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,CAAC,OAAO,CAAC;KAChB,CAAC;IAEF,uBAAuB;IACvB,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/config/paths.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Path Utilities
+ *
+ * Resolves paths for the MCP bridge executable.
+ */
+/**
+ * Get the path to this CLI executable.
+ * When installed via npm, this will be in node_modules/.bin/
+ * The MCP config needs to point to the actual executable.
+ */
+export declare function getBridgePath(): string;
+/**
+ * Get user's GitNexus config directory
+ */
+export declare function getGitNexusConfigDir(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CActC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C"}

package/dist/config/paths.js

@@ -0,0 +1,32 @@
+/**
+ * Path Utilities
+ *
+ * Resolves paths for the MCP bridge executable.
+ */
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+/**
+ * Get the path to this CLI executable.
+ * When installed via npm, this will be in node_modules/.bin/
+ * The MCP config needs to point to the actual executable.
+ */
+export function getBridgePath() {
+    // When running as ES module, we need to resolve from import.meta.url
+    // But for the installed package, we want the bin path
+    // Get the path to this module
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    // Go up from dist/config/ to the package root, then to the bin
+    const packageRoot = resolve(__dirname, '..', '..');
+    const binPath = resolve(packageRoot, 'dist', 'cli.js');
+    // Return as node command since it's a JS file
+    return `node ${binPath}`;
+}
+/**
+ * Get user's GitNexus config directory
+ */
+export function getGitNexusConfigDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return resolve(home, '.gitnexus');
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,qEAAqE;IACrE,sDAAsD;IAEtD,8BAA8B;IAC9B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtC,+DAA+D;IAC/D,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEvD,8CAA8C;IAC9C,OAAO,QAAQ,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/D,OAAO,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACpC,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP Server
+ *
+ * Model Context Protocol server that runs on stdio.
+ * External AI tools (Cursor, Claude Code) spawn this process and
+ * communicate via stdin/stdout using the MCP protocol.
+ *
+ * Exposes:
+ * - Tools: search, cypher, blastRadius, highlight
+ * - Resources: codebase context (stats, hotspots, folder tree)
+ */
+import type { CodebaseContext } from '../bridge/websocket-server.js';
+interface ToolCaller {
+    callTool(method: string, params: any): Promise<any>;
+    disconnect?(): void;
+    context?: CodebaseContext | null;
+    onContextChange?: (listener: (context: CodebaseContext | null) => void) => () => void;
+}
+export declare function startMCPServer(client: ToolCaller): Promise<void>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,UAAU,UAAU;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACpD,UAAU,CAAC,IAAI,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACvF;AAoED,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0HtE"}

package/dist/mcp/server.js

@@ -0,0 +1,183 @@
+/**
+ * MCP Server
+ *
+ * Model Context Protocol server that runs on stdio.
+ * External AI tools (Cursor, Claude Code) spawn this process and
+ * communicate via stdin/stdout using the MCP protocol.
+ *
+ * Exposes:
+ * - Tools: search, cypher, blastRadius, highlight
+ * - Resources: codebase context (stats, hotspots, folder tree)
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { GITNEXUS_TOOLS } from './tools.js';
+/**
+ * Format context as markdown for the resource
+ */
+function formatContextAsMarkdown(context) {
+    const { projectName, stats, hotspots, folderTree } = context;
+    const lines = [];
+    lines.push(`# GitNexus: ${projectName}`);
+    lines.push('');
+    lines.push('This codebase is currently loaded in GitNexus. Use the tools below to explore it.');
+    lines.push('');
+    // Stats
+    lines.push('## 📊 Statistics');
+    lines.push(`- **Files**: ${stats.fileCount}`);
+    lines.push(`- **Functions**: ${stats.functionCount}`);
+    if (stats.classCount > 0)
+        lines.push(`- **Classes**: ${stats.classCount}`);
+    if (stats.interfaceCount > 0)
+        lines.push(`- **Interfaces**: ${stats.interfaceCount}`);
+    if (stats.methodCount > 0)
+        lines.push(`- **Methods**: ${stats.methodCount}`);
+    lines.push('');
+    // Hotspots
+    if (hotspots.length > 0) {
+        lines.push('## 🔥 Hotspots (Most Connected Nodes)');
+        lines.push('');
+        hotspots.forEach(h => {
+            lines.push(`- \`${h.name}\` (${h.type}) — ${h.connections} connections — ${h.filePath}`);
+        });
+        lines.push('');
+    }
+    // Folder tree
+    if (folderTree) {
+        lines.push('## 📁 Project Structure');
+        lines.push('```');
+        lines.push(projectName + '/');
+        lines.push(folderTree);
+        lines.push('```');
+        lines.push('');
+    }
+    // Usage hints
+    lines.push('## 🛠️ Available Tools');
+    lines.push('');
+    lines.push('- **search**: Semantic search across the codebase');
+    lines.push('- **cypher**: Execute Cypher queries on the knowledge graph');
+    lines.push('- **blastRadius**: Analyze impact of changes to a node');
+    lines.push('- **highlight**: Visualize nodes in the graph');
+    lines.push('');
+    lines.push('## 📝 Graph Schema');
+    lines.push('');
+    lines.push('**Node Types**: File, Folder, Function, Class, Interface, Method');
+    lines.push('');
+    lines.push('**Relation**: `CodeRelation` with `type` property:');
+    lines.push('- CONTAINS, DEFINES, IMPORTS, CALLS, EXTENDS, IMPLEMENTS');
+    lines.push('');
+    lines.push('**Example Cypher Queries**:');
+    lines.push('```cypher');
+    lines.push('MATCH (f:Function) RETURN f.name LIMIT 10');
+    lines.push("MATCH (f:File)-[:CodeRelation {type: 'IMPORTS'}]->(g:File) RETURN f.name, g.name");
+    lines.push('```');
+    return lines.join('\n');
+}
+export async function startMCPServer(client) {
+    const server = new Server({
+        name: 'gitnexus',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    // Handle list resources request
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        const context = client.context;
+        if (!context) {
+            return { resources: [] };
+        }
+        return {
+            resources: [
+                {
+                    uri: 'gitnexus://codebase/context',
+                    name: `GitNexus: ${context.projectName}`,
+                    description: `Codebase context for ${context.projectName} (${context.stats.fileCount} files, ${context.stats.functionCount} functions)`,
+                    mimeType: 'text/markdown',
+                },
+            ],
+        };
+    });
+    // Handle read resource request
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        if (uri === 'gitnexus://codebase/context') {
+            const context = client.context;
+            if (!context) {
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'text/plain',
+                            text: 'No codebase loaded. Open GitNexus in your browser and load a repository.',
+                        },
+                    ],
+                };
+            }
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'text/markdown',
+                        text: formatContextAsMarkdown(context),
+                    },
+                ],
+            };
+        }
+        throw new Error(`Unknown resource: ${uri}`);
+    });
+    // Handle list tools request
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: GITNEXUS_TOOLS.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        })),
+    }));
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            // Forward the tool call to the browser via daemon
+            const result = await client.callTool(name, args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Connect to stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        client.disconnect?.();
+        await server.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        client.disconnect?.();
+        await server.close();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MCP Tool Definitions
+ *
+ * Defines the tools that GitNexus exposes to external AI agents.
+ * Each tool has a rich description with examples to help agents use them correctly.
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description?: string;
+            default?: any;
+            items?: {
+                type: string;
+            };
+        }>;
+        required: string[];
+    };
+}
+export declare const GITNEXUS_TOOLS: ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YACzB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,OAAO,CAAC,EAAE,GAAG,CAAC;YACd,KAAK,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC;SAC1B,CAAC,CAAC;QACH,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,eAAO,MAAM,cAAc,EAAE,cAAc,EA8J1C,CAAC"}

package/dist/mcp/tools.js

@@ -0,0 +1,166 @@
+/**
+ * MCP Tool Definitions
+ *
+ * Defines the tools that GitNexus exposes to external AI agents.
+ * Each tool has a rich description with examples to help agents use them correctly.
+ */
+export const GITNEXUS_TOOLS = [
+    {
+        name: 'context',
+        description: `Get GitNexus codebase context. CALL THIS FIRST before using other tools.
+
+Returns:
+- Project name and stats (files, functions, classes)
+- Hotspots (most connected/important nodes)
+- Directory structure (TOON format for token efficiency)
+- Tool usage guidance
+
+ALWAYS call this first to understand the codebase before searching or querying.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'search',
+        description: `Hybrid search (keyword + semantic) across the codebase.
+Returns code nodes with their graph connections.
+
+WHEN TO USE:
+- Finding implementations ("where is auth handled?")
+- Understanding code flow ("what calls UserService?")
+- Locating patterns ("find all API endpoints")
+
+RETURNS: Array of {name, type, filePath, code, connections[]}`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Natural language or keyword search query' },
+                limit: { type: 'number', description: 'Max results to return', default: 10 },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'cypher',
+        description: `Execute Cypher query against the code knowledge graph.
+
+SCHEMA:
+- Nodes: File, Function, Class, Interface, Method
+- Edges: CALLS, IMPORTS, EXTENDS, IMPLEMENTS, CONTAINS
+
+EXAMPLES:
+• Find callers of a function:
+  MATCH (a)-[:CALLS]->(b:Function {name: "validateUser"}) RETURN a.name, a.filePath
+
+• Find class hierarchy:
+  MATCH (c:Class)-[:EXTENDS*]->(base) WHERE c.name = "AdminUser" RETURN base.name
+
+• Impact analysis (what depends on X):
+  MATCH (target:Function {name: $name})<-[:CALLS*1..3]-(caller) RETURN DISTINCT caller
+
+TIPS:
+- Relationship types are UPPERCASE: CALLS, IMPORTS, EXTENDS
+- Node labels are PascalCase: Function, Class, Interface
+- Properties: name, filePath, code, startLine, endLine`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Cypher query to execute' },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'grep',
+        description: `Regex search for exact patterns in file contents.
+
+WHEN TO USE:
+- Finding exact strings: error codes, TODOs, specific API keys
+- Pattern matching: all console.log, all fetch calls
+- Finding imports of specific modules
+
+BETTER THAN search for: exact matches, regex patterns, case-sensitive
+
+RETURNS: Array of {filePath, line, lineNumber, match}`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                pattern: { type: 'string', description: 'Regex pattern to search for' },
+                caseSensitive: { type: 'boolean', description: 'Case-sensitive search', default: false },
+                maxResults: { type: 'number', description: 'Max results to return', default: 50 },
+            },
+            required: ['pattern'],
+        },
+    },
+    {
+        name: 'read',
+        description: `Read file content from the codebase.
+
+WHEN TO USE:
+- After search/grep to see full context
+- To understand implementation details
+- Before making changes
+
+ALWAYS read before concluding - don't guess from names alone.
+
+RETURNS: {filePath, content, language, lines}`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filePath: { type: 'string', description: 'Path to file to read' },
+                startLine: { type: 'number', description: 'Start line (optional)' },
+                endLine: { type: 'number', description: 'End line (optional)' },
+            },
+            required: ['filePath'],
+        },
+    },
+    {
+        name: 'blastRadius',
+        description: `Analyze the impact of changing a code element.
+Returns all nodes affected by modifying the target, with distance, edge type, and confidence.
+
+USE BEFORE making changes to understand ripple effects.
+
+Output format (compact tabular):
+  Type|Name|File:Line|EdgeType|Confidence%
+
+EdgeType: CALLS, IMPORTS, EXTENDS, IMPLEMENTS
+Confidence: 100% = certain, <80% = fuzzy match [fuzzy]
+
+Depth groups:
+- d=1: WILL BREAK (direct callers/importers)
+- d=2: LIKELY AFFECTED (indirect)
+- d=3: MAY NEED TESTING (transitive)`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                target: { type: 'string', description: 'Name of function, class, or file to analyze' },
+                direction: { type: 'string', description: 'upstream (what depends on this) or downstream (what this depends on)' },
+                maxDepth: { type: 'number', description: 'Max relationship depth (default: 3)', default: 3 },
+                relationTypes: { type: 'array', items: { type: 'string' }, description: 'Filter: CALLS, IMPORTS, EXTENDS, IMPLEMENTS, CONTAINS, DEFINES (default: usage-based)' },
+                includeTests: { type: 'boolean', description: 'Include test files (default: false)' },
+                minConfidence: { type: 'number', description: 'Minimum confidence 0-1 (default: 0.7)' },
+            },
+            required: ['target', 'direction'],
+        },
+    },
+    {
+        name: 'highlight',
+        description: `Highlight nodes in the GitNexus graph visualization.
+Use after search/analysis to show the user what you found.
+
+The user will see the nodes glow in the graph view.
+Great for visual confirmation of your findings.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                nodeIds: { type: 'array', items: { type: 'string' }, description: 'Array of node IDs to highlight' },
+                color: { type: 'string', description: 'Highlight color (optional, default: cyan)' },
+            },
+            required: ['nodeIds'],
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+    "name": "gitnexus-mcp",
+    "version": "0.1.0",
+    "description": "MCP server for GitNexus code intelligence - connect Cursor, Claude, and other AI agents to your codebase",
+    "author": "Abhigyan Patwari",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/abhigyanpatwari/GitNexus"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "code-intelligence",
+        "cursor",
+        "claude",
+        "ai-agent",
+        "gitnexus"
+    ],
+    "type": "module",
+    "bin": {
+        "gitnexus-mcp": "./dist/cli.js"
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsx watch src/cli.ts",
+        "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.0.0",
+        "ws": "^8.16.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "@types/ws": "^8.5.10",
+        "typescript": "^5.4.0",
+        "tsx": "^4.0.0"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}