@know-graph/mcp-server 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KnowGraph Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# @know-graph/mcp-server
+
+MCP (Model Context Protocol) server for [KnowGraph](https://github.com/idosams/know-know) — connect your code knowledge graph to AI assistants.
+
+## Installation
+
+```bash
+npm install -g @know-graph/cli
+# The MCP server is included with the CLI
+```
+
+Or install standalone:
+
+```bash
+npm install @know-graph/mcp-server
+```
+
+## Usage with Claude Desktop
+
+Add to your Claude Desktop configuration (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "knowgraph": {
+      "command": "knowgraph",
+      "args": ["serve", "--db", "/path/to/project/.knowgraph/knowgraph.db"]
+    }
+  }
+}
+```
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_code` | Full-text search across entity names, descriptions, and tags |
+| `find_by_owner` | Find all entities owned by a specific team or person |
+| `find_by_business_goal` | Discover entities related to a business objective |
+| `get_dependencies` | Map dependencies for an entity (services, APIs, databases) |
+| `get_entity_details` | Get complete metadata for a specific entity |
+| `get_external_knowledge` | Find linked external resources (Notion, Jira, dashboards) |
+| `graph_overview` | Get high-level statistics about the indexed codebase |
+
+## Documentation
+
+See the [main repository](https://github.com/idosams/know-know) for full documentation, annotation format, and examples.
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+export declare function generateClaudeDesktopConfig(projectPath: string): object;
+//# 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,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAevE"}

package/dist/config.js

@@ -0,0 +1,26 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Claude Desktop MCP configuration generator
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, config, claude-desktop]
+ * context:
+ *   business_goal: Simplify MCP server setup for Claude Desktop users
+ *   domain: mcp-server
+ */
+import path from 'node:path';
+export function generateClaudeDesktopConfig(projectPath) {
+    return {
+        mcpServers: {
+            knowgraph: {
+                command: 'node',
+                args: [
+                    path.join(projectPath, 'node_modules/@know-graph/mcp-server/dist/index.js'),
+                    path.join(projectPath, '.knowgraph/knowgraph.db'),
+                ],
+            },
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,OAAO;QACL,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE;oBACJ,IAAI,CAAC,IAAI,CACP,WAAW,EACX,mDAAmD,CACpD;oBACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,yBAAyB,CAAC;iBAClD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Read-only SQLite database layer for MCP server queries
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, database, sqlite, readonly]
+ * context:
+ *   business_goal: Provide efficient read-only access to the code knowledge graph
+ *   domain: mcp-server
+ */
+import Database from 'better-sqlite3';
+export interface EntityRow {
+    readonly id: string;
+    readonly name: string;
+    readonly file_path: string;
+    readonly line: number;
+    readonly column: number;
+    readonly language: string;
+    readonly entity_type: string;
+    readonly description: string;
+    readonly owner: string | null;
+    readonly status: string | null;
+    readonly tags: string | null;
+    readonly links: string | null;
+    readonly signature: string | null;
+    readonly parent: string | null;
+    readonly raw_docstring: string | null;
+    readonly business_goal: string | null;
+    readonly funnel_stage: string | null;
+    readonly revenue_impact: string | null;
+    readonly dependencies: string | null;
+    readonly compliance: string | null;
+    readonly operational: string | null;
+}
+export interface LinkRow {
+    readonly entity_id: string;
+    readonly type: string | null;
+    readonly url: string;
+    readonly title: string | null;
+}
+export interface DependencyRow {
+    readonly source_id: string;
+    readonly target_id: string;
+    readonly dependency_type: string;
+}
+export interface GraphStats {
+    readonly totalEntities: number;
+    readonly entityTypes: ReadonlyArray<{
+        readonly type: string;
+        readonly count: number;
+    }>;
+    readonly totalLinks: number;
+    readonly totalDependencies: number;
+    readonly owners: ReadonlyArray<string>;
+    readonly languages: ReadonlyArray<string>;
+}
+export interface SearchFilters {
+    readonly type?: string;
+    readonly owner?: string;
+    readonly tags?: readonly string[];
+    readonly limit?: number;
+}
+export interface McpDatabase {
+    search(query: string, filters?: SearchFilters): readonly EntityRow[];
+    getById(id: string): EntityRow | undefined;
+    getByOwner(owner: string): readonly EntityRow[];
+    getDependencies(entityId: string, depth?: number): readonly DependencyRow[];
+    getLinks(entityId?: string): readonly LinkRow[];
+    getByBusinessGoal(goal: string): readonly EntityRow[];
+    getStats(): GraphStats;
+    close(): void;
+}
+export declare function openDatabase(dbPath: string): McpDatabase;
+export declare function createInMemoryDatabase(): {
+    readonly db: McpDatabase;
+    readonly rawDb: Database.Database;
+};
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

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

package/dist/db.js

@@ -0,0 +1,211 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Read-only SQLite database layer for MCP server queries
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, database, sqlite, readonly]
+ * context:
+ *   business_goal: Provide efficient read-only access to the code knowledge graph
+ *   domain: mcp-server
+ */
+import Database from 'better-sqlite3';
+function buildFilterClause(filters) {
+    const conditions = [];
+    const params = [];
+    if (filters?.type) {
+        conditions.push('e.entity_type = ?');
+        params.push(filters.type);
+    }
+    if (filters?.owner) {
+        conditions.push('e.owner = ?');
+        params.push(filters.owner);
+    }
+    if (filters?.tags && filters.tags.length > 0) {
+        const tagConditions = filters.tags.map(() => 'e.tags LIKE ?');
+        conditions.push(`(${tagConditions.join(' AND ')})`);
+        for (const tag of filters.tags) {
+            params.push(`%${tag}%`);
+        }
+    }
+    const where = conditions.length > 0 ? ` AND ${conditions.join(' AND ')}` : '';
+    return { where, params };
+}
+function hasFtsTable(db) {
+    try {
+        const row = db
+            .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='entities_fts'")
+            .get();
+        return row !== undefined;
+    }
+    catch {
+        return false;
+    }
+}
+function createDatabaseApi(db, ftsEnabled) {
+    const search = (query, filters) => {
+        const limit = filters?.limit ?? 20;
+        const { where: filterWhere, params: filterParams } = buildFilterClause(filters);
+        if (ftsEnabled && query.trim().length > 0) {
+            try {
+                const stmt = db.prepare(`
+          SELECT e.* FROM entities e
+          WHERE e.rowid IN (SELECT rowid FROM entities_fts WHERE entities_fts MATCH ?)${filterWhere}
+          LIMIT ?
+        `);
+                return stmt.all(query, ...filterParams, limit);
+            }
+            catch {
+                // Fall through to LIKE search if FTS query syntax is invalid
+            }
+        }
+        const stmt = db.prepare(`
+      SELECT * FROM entities e
+      WHERE (e.name LIKE ? OR e.description LIKE ?)${filterWhere}
+      LIMIT ?
+    `);
+        const pattern = `%${query}%`;
+        return stmt.all(pattern, pattern, ...filterParams, limit);
+    };
+    const getById = (id) => {
+        return db.prepare('SELECT * FROM entities WHERE id = ?').get(id);
+    };
+    const getByOwner = (owner) => {
+        return db
+            .prepare('SELECT * FROM entities WHERE owner = ?')
+            .all(owner);
+    };
+    const getDependencies = (entityId, depth = 1) => {
+        if (depth <= 1) {
+            return db
+                .prepare('SELECT * FROM dependencies WHERE source_id = ? OR target_id = ?')
+                .all(entityId, entityId);
+        }
+        const visited = new Set();
+        const result = [];
+        const queue = [{ id: entityId, currentDepth: 0 }];
+        const stmt = db.prepare('SELECT * FROM dependencies WHERE source_id = ? OR target_id = ?');
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (visited.has(current.id) || current.currentDepth >= depth) {
+                continue;
+            }
+            visited.add(current.id);
+            const deps = stmt.all(current.id, current.id);
+            for (const dep of deps) {
+                result.push(dep);
+                const nextId = dep.source_id === current.id ? dep.target_id : dep.source_id;
+                if (!visited.has(nextId)) {
+                    queue.push({ id: nextId, currentDepth: current.currentDepth + 1 });
+                }
+            }
+        }
+        return result;
+    };
+    const getLinks = (entityId) => {
+        if (entityId) {
+            return db
+                .prepare('SELECT * FROM links WHERE entity_id = ?')
+                .all(entityId);
+        }
+        return db.prepare('SELECT * FROM links').all();
+    };
+    const getByBusinessGoal = (goal) => {
+        const pattern = `%${goal}%`;
+        return db
+            .prepare('SELECT * FROM entities WHERE business_goal LIKE ? OR description LIKE ?')
+            .all(pattern, pattern);
+    };
+    const getStats = () => {
+        const totalEntities = db.prepare('SELECT COUNT(*) as count FROM entities').get().count;
+        const entityTypes = db
+            .prepare('SELECT entity_type as type, COUNT(*) as count FROM entities GROUP BY entity_type')
+            .all();
+        const totalLinks = db.prepare('SELECT COUNT(*) as count FROM links').get().count;
+        const totalDependencies = db.prepare('SELECT COUNT(*) as count FROM dependencies').get().count;
+        const ownerRows = db
+            .prepare('SELECT DISTINCT owner FROM entities WHERE owner IS NOT NULL')
+            .all();
+        const languageRows = db
+            .prepare('SELECT DISTINCT language FROM entities')
+            .all();
+        return {
+            totalEntities,
+            entityTypes,
+            totalLinks,
+            totalDependencies,
+            owners: ownerRows.map((r) => r.owner),
+            languages: languageRows.map((r) => r.language),
+        };
+    };
+    const close = () => {
+        db.close();
+    };
+    return {
+        search,
+        getById,
+        getByOwner,
+        getDependencies,
+        getLinks,
+        getByBusinessGoal,
+        getStats,
+        close,
+    };
+}
+export function openDatabase(dbPath) {
+    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+    db.pragma('journal_mode = WAL');
+    return createDatabaseApi(db, hasFtsTable(db));
+}
+export function createInMemoryDatabase() {
+    const rawDb = new Database(':memory:');
+    rawDb.exec(`
+    CREATE TABLE entities (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      line INTEGER NOT NULL,
+      column INTEGER NOT NULL,
+      language TEXT NOT NULL,
+      entity_type TEXT NOT NULL,
+      description TEXT NOT NULL,
+      owner TEXT,
+      status TEXT,
+      tags TEXT,
+      links TEXT,
+      signature TEXT,
+      parent TEXT,
+      raw_docstring TEXT,
+      business_goal TEXT,
+      funnel_stage TEXT,
+      revenue_impact TEXT,
+      dependencies TEXT,
+      compliance TEXT,
+      operational TEXT
+    );
+
+    CREATE TABLE links (
+      entity_id TEXT NOT NULL,
+      type TEXT,
+      url TEXT NOT NULL,
+      title TEXT,
+      FOREIGN KEY (entity_id) REFERENCES entities(id)
+    );
+
+    CREATE TABLE dependencies (
+      source_id TEXT NOT NULL,
+      target_id TEXT NOT NULL,
+      dependency_type TEXT NOT NULL,
+      FOREIGN KEY (source_id) REFERENCES entities(id),
+      FOREIGN KEY (target_id) REFERENCES entities(id)
+    );
+
+    CREATE VIRTUAL TABLE entities_fts USING fts5(
+      name, description, tags, business_goal,
+      content='entities',
+      content_rowid='rowid'
+    );
+  `);
+    return { db: createDatabaseApi(rawDb, true), rawDb };
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+export { createServer, startServer } from './server.js';
+export type { ServerOptions } from './server.js';
+export { openDatabase, createInMemoryDatabase } from './db.js';
+export type { McpDatabase, EntityRow, LinkRow, DependencyRow, GraphStats, SearchFilters, } from './db.js';
+export { generateClaudeDesktopConfig } from './config.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":";AAcA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAC/D,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,aAAa,EACb,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * @knowgraph
+ * type: module
+ * description: MCP server entrypoint with exports and direct-run capability
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, entrypoint, exports]
+ * context:
+ *   business_goal: Provide the main entry point for the MCP server package
+ *   domain: mcp-server
+ */
+import { startServer } from './server.js';
+export { createServer, startServer } from './server.js';
+export { openDatabase, createInMemoryDatabase } from './db.js';
+export { generateClaudeDesktopConfig } from './config.js';
+const isDirectRun = process.argv[1]?.endsWith('mcp-server/dist/index.js') ||
+    process.argv[1]?.endsWith('mcp-server/src/index.ts');
+if (isDirectRun) {
+    const dbPath = process.argv[2] || '.knowgraph/knowgraph.db';
+    const verbose = process.argv.includes('--verbose');
+    startServer({ dbPath, verbose }).catch((error) => {
+        console.error('Failed to start MCP server:', 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":";AACA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAS/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,0BAA0B,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAEvD,IAAI,WAAW,EAAE,CAAC;IAChB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,yBAAyB,CAAC;IAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAEnD,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/C,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @knowgraph
+ * type: service
+ * description: MCP server factory and stdio transport initialization
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, server, transport, stdio]
+ * context:
+ *   business_goal: Expose code graph data to AI assistants via MCP protocol
+ *   domain: mcp-server
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface ServerOptions {
+    readonly dbPath: string;
+    readonly verbose?: boolean;
+}
+export declare function createServer(options: ServerOptions): McpServer;
+export declare function startServer(options: ServerOptions): Promise<void>;
+//# 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;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAgC9D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}

package/dist/server.js

@@ -0,0 +1,47 @@
+/**
+ * @knowgraph
+ * type: service
+ * description: MCP server factory and stdio transport initialization
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, server, transport, stdio]
+ * context:
+ *   business_goal: Expose code graph data to AI assistants via MCP protocol
+ *   domain: mcp-server
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { openDatabase } from './db.js';
+import { registerAllTools } from './tools/index.js';
+export function createServer(options) {
+    const server = new McpServer({
+        name: 'knowgraph',
+        version: '0.1.0',
+    });
+    try {
+        const db = openDatabase(options.dbPath);
+        registerAllTools(server, db);
+    }
+    catch (error) {
+        if (options.verbose) {
+            console.error(`Failed to open database at ${options.dbPath}:`, error);
+        }
+        // Register a single tool that reports the database error
+        server.tool('get_graph_overview', 'Get statistics and overview of the indexed codebase', {}, async () => ({
+            content: [
+                {
+                    type: 'text',
+                    text: `Database not available at ${options.dbPath}. Run 'knowgraph index' to create it.`,
+                },
+            ],
+            isError: true,
+        }));
+    }
+    return server;
+}
+export async function startServer(options) {
+    const server = createServer(options);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAOpD,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,8BAA8B,OAAO,CAAC,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC;QACxE,CAAC;QAED,yDAAyD;QACzD,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,qDAAqD,EACrD,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,CAAC;YACX,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,6BAA6B,OAAO,CAAC,MAAM,uCAAuC;iBACzF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAsB;IACtD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/find-by-business-goal.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpDatabase } from '../db.js';
+export declare function registerFindByBusinessGoal(server: McpServer, db: McpDatabase): void;
+//# sourceMappingURL=find-by-business-goal.d.ts.map

package/dist/tools/find-by-business-goal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-by-business-goal.d.ts","sourceRoot":"","sources":["../../src/tools/find-by-business-goal.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,WAAW,GACd,IAAI,CA2BN"}

package/dist/tools/find-by-business-goal.js

@@ -0,0 +1,37 @@
+/**
+ * @knowgraph
+ * type: function
+ * description: MCP tool that finds code entities linked to a business objective
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, tool, business, goal]
+ * context:
+ *   business_goal: Bridge business objectives to code ownership for AI assistants
+ *   domain: mcp-tools
+ */
+import { z } from 'zod';
+import { formatEntityList } from './format.js';
+export function registerFindByBusinessGoal(server, db) {
+    server.tool('find_code_by_business_goal', 'Find code entities related to a specific business goal or context', {
+        goal: z.string().describe('Business goal or context to search for'),
+    }, async (params) => {
+        try {
+            const results = db.getByBusinessGoal(params.goal);
+            return {
+                content: [{ type: 'text', text: formatEntityList(results) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error finding by business goal: ${String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=find-by-business-goal.js.map

package/dist/tools/find-by-business-goal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-by-business-goal.js","sourceRoot":"","sources":["../../src/tools/find-by-business-goal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,EAAe;IAEf,MAAM,CAAC,IAAI,CACT,4BAA4B,EAC5B,mEAAmE,EACnE;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KACpE,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAElD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;aACtE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,mCAAmC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACzD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/find-by-owner.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpDatabase } from '../db.js';
+export declare function registerFindByOwner(server: McpServer, db: McpDatabase): void;
+//# sourceMappingURL=find-by-owner.d.ts.map

package/dist/tools/find-by-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-by-owner.d.ts","sourceRoot":"","sources":["../../src/tools/find-by-owner.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CA2B5E"}

package/dist/tools/find-by-owner.js

@@ -0,0 +1,37 @@
+/**
+ * @knowgraph
+ * type: function
+ * description: MCP tool that finds code entities belonging to a specific team or owner
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, tool, owner, team]
+ * context:
+ *   business_goal: Enable AI assistants to find code by team ownership
+ *   domain: mcp-tools
+ */
+import { z } from 'zod';
+import { formatEntityList } from './format.js';
+export function registerFindByOwner(server, db) {
+    server.tool('find_code_by_owner', 'Find all code entities owned by a specific team or person', {
+        owner: z.string().describe('Owner name or team to search for'),
+    }, async (params) => {
+        try {
+            const results = db.getByOwner(params.owner);
+            return {
+                content: [{ type: 'text', text: formatEntityList(results) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error finding by owner: ${String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=find-by-owner.js.map

package/dist/tools/find-by-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-by-owner.js","sourceRoot":"","sources":["../../src/tools/find-by-owner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,EAAe;IACpE,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,2DAA2D,EAC3D;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KAC/D,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAE5C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;aACtE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2BAA2B,MAAM,CAAC,KAAK,CAAC,EAAE;qBACjD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/format.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Formatting utilities for MCP tool responses (entities, dependencies, links, stats)
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, formatting, output, markdown]
+ * context:
+ *   business_goal: Present code graph data in clean, readable formats for AI consumption
+ *   domain: mcp-tools
+ */
+import type { EntityRow, DependencyRow, LinkRow, GraphStats } from '../db.js';
+export declare function formatEntity(entity: EntityRow): string;
+export declare function formatEntityList(entities: readonly EntityRow[]): string;
+export declare function formatDependencies(entityId: string, deps: readonly DependencyRow[]): string;
+export declare function formatLinks(links: readonly LinkRow[]): string;
+export declare function formatStats(stats: GraphStats): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/tools/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE9E,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAoBtD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAKvE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,aAAa,EAAE,GAC7B,MAAM,CAyBR;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAY7D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAyBrD"}

package/dist/tools/format.js

@@ -0,0 +1,86 @@
+export function formatEntity(entity) {
+    const lines = [
+        `## ${entity.name} (${entity.entity_type})`,
+        `**File:** ${entity.file_path}:${entity.line}`,
+        `**Description:** ${entity.description}`,
+    ];
+    if (entity.owner)
+        lines.push(`**Owner:** ${entity.owner}`);
+    if (entity.status)
+        lines.push(`**Status:** ${entity.status}`);
+    if (entity.language)
+        lines.push(`**Language:** ${entity.language}`);
+    if (entity.signature)
+        lines.push(`**Signature:** \`${entity.signature}\``);
+    if (entity.tags)
+        lines.push(`**Tags:** ${entity.tags}`);
+    if (entity.business_goal)
+        lines.push(`**Business Goal:** ${entity.business_goal}`);
+    if (entity.funnel_stage)
+        lines.push(`**Funnel Stage:** ${entity.funnel_stage}`);
+    if (entity.revenue_impact)
+        lines.push(`**Revenue Impact:** ${entity.revenue_impact}`);
+    return lines.join('\n');
+}
+export function formatEntityList(entities) {
+    if (entities.length === 0) {
+        return 'No entities found.';
+    }
+    return entities.map(formatEntity).join('\n\n---\n\n');
+}
+export function formatDependencies(entityId, deps) {
+    if (deps.length === 0) {
+        return `No dependencies found for entity: ${entityId}`;
+    }
+    const outgoing = deps.filter((d) => d.source_id === entityId);
+    const incoming = deps.filter((d) => d.target_id === entityId);
+    const lines = [`## Dependencies for ${entityId}`];
+    if (outgoing.length > 0) {
+        lines.push('\n### Depends On');
+        for (const dep of outgoing) {
+            lines.push(`- ${dep.target_id} (${dep.dependency_type})`);
+        }
+    }
+    if (incoming.length > 0) {
+        lines.push('\n### Depended On By');
+        for (const dep of incoming) {
+            lines.push(`- ${dep.source_id} (${dep.dependency_type})`);
+        }
+    }
+    return lines.join('\n');
+}
+export function formatLinks(links) {
+    if (links.length === 0) {
+        return 'No external links found.';
+    }
+    return links
+        .map((link) => {
+        const title = link.title ?? link.url;
+        const type = link.type ? ` [${link.type}]` : '';
+        return `- ${title}${type}: ${link.url} (entity: ${link.entity_id})`;
+    })
+        .join('\n');
+}
+export function formatStats(stats) {
+    const lines = [
+        '## KnowGraph Overview',
+        '',
+        `**Total Entities:** ${stats.totalEntities}`,
+        `**Total Links:** ${stats.totalLinks}`,
+        `**Total Dependencies:** ${stats.totalDependencies}`,
+    ];
+    if (stats.entityTypes.length > 0) {
+        lines.push('\n### Entity Types');
+        for (const et of stats.entityTypes) {
+            lines.push(`- ${et.type}: ${et.count}`);
+        }
+    }
+    if (stats.owners.length > 0) {
+        lines.push(`\n### Owners\n${stats.owners.join(', ')}`);
+    }
+    if (stats.languages.length > 0) {
+        lines.push(`\n### Languages\n${stats.languages.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/tools/format.js.map

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

package/dist/tools/get-dependencies.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpDatabase } from '../db.js';
+export declare function registerGetDependencies(server: McpServer, db: McpDatabase): void;
+//# sourceMappingURL=get-dependencies.d.ts.map

package/dist/tools/get-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dependencies.d.ts","sourceRoot":"","sources":["../../src/tools/get-dependencies.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,WAAW,GACd,IAAI,CAoCN"}

package/dist/tools/get-dependencies.js

@@ -0,0 +1,46 @@
+/**
+ * @knowgraph
+ * type: function
+ * description: MCP tool that retrieves dependency graph for a code entity
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, tool, dependencies, graph]
+ * context:
+ *   business_goal: Enable AI assistants to understand code relationships and impact
+ *   domain: mcp-tools
+ */
+import { z } from 'zod';
+import { formatDependencies } from './format.js';
+export function registerGetDependencies(server, db) {
+    server.tool('get_code_dependencies', 'Get the dependency tree for a specific code entity', {
+        entity_id: z.string().describe('The entity ID to get dependencies for'),
+        depth: z
+            .number()
+            .optional()
+            .describe('How many levels deep to traverse (default 1)'),
+    }, async (params) => {
+        try {
+            const deps = db.getDependencies(params.entity_id, params.depth);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatDependencies(params.entity_id, deps),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting dependencies: ${String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-dependencies.js.map

package/dist/tools/get-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dependencies.js","sourceRoot":"","sources":["../../src/tools/get-dependencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,EAAe;IAEf,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,oDAAoD,EACpD;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACvE,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8CAA8C,CAAC;KAC5D,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAEhE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC;qBACjD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,+BAA+B,MAAM,CAAC,KAAK,CAAC,EAAE;qBACrD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-entity-details.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpDatabase } from '../db.js';
+export declare function registerGetEntityDetails(server: McpServer, db: McpDatabase): void;
+//# sourceMappingURL=get-entity-details.d.ts.map

package/dist/tools/get-entity-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-details.d.ts","sourceRoot":"","sources":["../../src/tools/get-entity-details.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,WAAW,GACd,IAAI,CAmDN"}

package/dist/tools/get-entity-details.js

@@ -0,0 +1,58 @@
+/**
+ * @knowgraph
+ * type: function
+ * description: MCP tool that returns full metadata for a specific code entity
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, tool, details, metadata]
+ * context:
+ *   business_goal: Provide comprehensive entity information to AI assistants
+ *   domain: mcp-tools
+ */
+import { z } from 'zod';
+import { formatEntity, formatLinks, formatDependencies } from './format.js';
+export function registerGetEntityDetails(server, db) {
+    server.tool('get_entity_details', 'Get full metadata for a specific code entity including links and dependencies', {
+        entity_id: z.string().describe('The entity ID to look up'),
+    }, async (params) => {
+        try {
+            const entity = db.getById(params.entity_id);
+            if (!entity) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Entity not found: ${params.entity_id}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const links = db.getLinks(params.entity_id);
+            const deps = db.getDependencies(params.entity_id);
+            const sections = [
+                formatEntity(entity),
+                '',
+                '### External Links',
+                formatLinks(links),
+                '',
+                formatDependencies(params.entity_id, deps),
+            ];
+            return {
+                content: [{ type: 'text', text: sections.join('\n') }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting entity details: ${String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-entity-details.js.map

package/dist/tools/get-entity-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-details.js","sourceRoot":"","sources":["../../src/tools/get-entity-details.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,UAAU,wBAAwB,CACtC,MAAiB,EACjB,EAAe;IAEf,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,+EAA+E,EAC/E;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KAC3D,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAE5C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,qBAAqB,MAAM,CAAC,SAAS,EAAE;yBAC9C;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAElD,MAAM,QAAQ,GAAG;gBACf,YAAY,CAAC,MAAM,CAAC;gBACpB,EAAE;gBACF,oBAAoB;gBACpB,WAAW,CAAC,KAAK,CAAC;gBAClB,EAAE;gBACF,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC;aAC3C,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aAChE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iCAAiC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACvD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-external-knowledge.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpDatabase } from '../db.js';
+export declare function registerGetExternalKnowledge(server: McpServer, db: McpDatabase): void;
+//# sourceMappingURL=get-external-knowledge.d.ts.map

package/dist/tools/get-external-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-external-knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/get-external-knowledge.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,WAAW,GACd,IAAI,CAsCN"}

package/dist/tools/get-external-knowledge.js

@@ -0,0 +1,47 @@
+/**
+ * @knowgraph
+ * type: function
+ * description: MCP tool that retrieves external documentation links for entities
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, tool, links, documentation]
+ * context:
+ *   business_goal: Connect code to external knowledge sources for AI assistants
+ *   domain: mcp-tools
+ */
+import { z } from 'zod';
+import { formatLinks } from './format.js';
+export function registerGetExternalKnowledge(server, db) {
+    server.tool('get_external_knowledge', 'Get external links (Notion, Jira, etc.) for an entity or all entities', {
+        entity_id: z
+            .string()
+            .optional()
+            .describe('Entity ID to get links for (omit for all)'),
+        type: z
+            .string()
+            .optional()
+            .describe('Link type filter (notion, jira, linear, etc.)'),
+    }, async (params) => {
+        try {
+            const allLinks = db.getLinks(params.entity_id);
+            const filtered = params.type
+                ? allLinks.filter((link) => link.type === params.type)
+                : allLinks;
+            return {
+                content: [{ type: 'text', text: formatLinks(filtered) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting external knowledge: ${String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-external-knowledge.js.map

package/dist/tools/get-external-knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-external-knowledge.js","sourceRoot":"","sources":["../../src/tools/get-external-knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,4BAA4B,CAC1C,MAAiB,EACjB,EAAe;IAEf,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,uEAAuE,EACvE;QACE,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,2CAA2C,CAAC;QACxD,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,+CAA+C,CAAC;KAC7D,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAE/C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI;gBAC1B,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC;gBACtD,CAAC,CAAC,QAAQ,CAAC;YAEb,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;aAClE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qCAAqC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC3D;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/graph-overview.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @knowgraph
+ * type: function
+ * description: MCP tool that provides codebase-wide statistics and summary
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, tool, overview, statistics]
+ * context:
+ *   business_goal: Give AI assistants a high-level view of the codebase
+ *   domain: mcp-tools
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpDatabase } from '../db.js';
+export declare function registerGraphOverview(server: McpServer, db: McpDatabase): void;
+//# sourceMappingURL=graph-overview.d.ts.map

package/dist/tools/graph-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-overview.d.ts","sourceRoot":"","sources":["../../src/tools/graph-overview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,WAAW,GACd,IAAI,CAyBN"}

package/dist/tools/graph-overview.js

@@ -0,0 +1,23 @@
+import { formatStats } from './format.js';
+export function registerGraphOverview(server, db) {
+    server.tool('get_graph_overview', 'Get statistics and overview of the indexed codebase', {}, async () => {
+        try {
+            const stats = db.getStats();
+            return {
+                content: [{ type: 'text', text: formatStats(stats) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting graph overview: ${String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=graph-overview.js.map

package/dist/tools/graph-overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-overview.js","sourceRoot":"","sources":["../../src/tools/graph-overview.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,EAAe;IAEf,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,qDAAqD,EACrD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;YAE5B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;aAC/D,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iCAAiC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACvD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Tool registry that registers all MCP tools with the server
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, tools, registry, aggregator]
+ * context:
+ *   business_goal: Centralize MCP tool registration for clean server initialization
+ *   domain: mcp-tools
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpDatabase } from '../db.js';
+export declare function registerAllTools(server: McpServer, db: McpDatabase): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAS5C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAQzE"}

package/dist/tools/index.js

@@ -0,0 +1,17 @@
+import { registerSearchCode } from './search-code.js';
+import { registerFindByOwner } from './find-by-owner.js';
+import { registerFindByBusinessGoal } from './find-by-business-goal.js';
+import { registerGetDependencies } from './get-dependencies.js';
+import { registerGetEntityDetails } from './get-entity-details.js';
+import { registerGetExternalKnowledge } from './get-external-knowledge.js';
+import { registerGraphOverview } from './graph-overview.js';
+export function registerAllTools(server, db) {
+    registerSearchCode(server, db);
+    registerFindByOwner(server, db);
+    registerFindByBusinessGoal(server, db);
+    registerGetDependencies(server, db);
+    registerGetEntityDetails(server, db);
+    registerGetExternalKnowledge(server, db);
+    registerGraphOverview(server, db);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,EAAe;IACjE,kBAAkB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/B,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChC,0BAA0B,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvC,uBAAuB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACpC,wBAAwB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrC,4BAA4B,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzC,qBAAqB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/tools/search-code.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpDatabase } from '../db.js';
+export declare function registerSearchCode(server: McpServer, db: McpDatabase): void;
+//# sourceMappingURL=search-code.d.ts.map

package/dist/tools/search-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-code.d.ts","sourceRoot":"","sources":["../../src/tools/search-code.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAuC3E"}

package/dist/tools/search-code.js

@@ -0,0 +1,49 @@
+/**
+ * @knowgraph
+ * type: function
+ * description: MCP tool that provides full-text search across code entities
+ * owner: knowgraph-mcp
+ * status: stable
+ * tags: [mcp, tool, search, fts5]
+ * context:
+ *   business_goal: Enable AI assistants to search codebases by keyword
+ *   domain: mcp-tools
+ */
+import { z } from 'zod';
+import { formatEntityList } from './format.js';
+export function registerSearchCode(server, db) {
+    server.tool('search_code', 'Search for code entities by description, name, or tags', {
+        query: z.string().describe('Search query text'),
+        type: z
+            .string()
+            .optional()
+            .describe('Entity type filter (e.g., function, class, module)'),
+        owner: z.string().optional().describe('Owner/team filter'),
+        tags: z.array(z.string()).optional().describe('Tag filters'),
+        limit: z.number().optional().describe('Max results (default 20)'),
+    }, async (params) => {
+        try {
+            const results = db.search(params.query, {
+                type: params.type,
+                owner: params.owner,
+                tags: params.tags,
+                limit: params.limit,
+            });
+            return {
+                content: [{ type: 'text', text: formatEntityList(results) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error searching code: ${String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=search-code.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-code.js","sourceRoot":"","sources":["../../src/tools/search-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,EAAe;IACnE,MAAM,CAAC,IAAI,CACT,aAAa,EACb,wDAAwD,EACxD;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC/C,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,oDAAoD,CAAC;QACjE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC5D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KAClE,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;gBACtC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;aACtE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,yBAAyB,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC/C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@know-graph/mcp-server",
+  "version": "0.4.0",
+  "description": "MCP server for KnowGraph",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/idosams/know-know.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://github.com/idosams/know-know#readme",
+  "bugs": {
+    "url": "https://github.com/idosams/know-know/issues"
+  },
+  "keywords": [
+    "knowgraph",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "code-knowledge"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "knowgraph-mcp": "dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.0.0",
+    "zod": "^3.24.0",
+    "@know-graph/core": "0.4.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}