@chinjinyu/mcp-knowledge-graph-plus 0.1.1

package/dist/interfaces/mcp/commands/NodeDelCommand.js

@@ -0,0 +1,63 @@
+import { BaseCommand } from './BaseCommand.js';
+export class NodeDelCommand extends BaseCommand {
+    nodeService;
+    factRepo;
+    linkRepo;
+    name = 'kg_node_del';
+    description = `Delete nodes from the knowledge graph. This will cascade delete all facts attached to the node and all links connected to it. Non-existent nodes are silently ignored.
+
+Examples:
+1. Delete a single node:
+   { "names": ["Alice"] }
+
+2. Delete multiple nodes:
+   { "names": ["Alice", "Bob", "OldProject"] }
+
+3. Delete with cleanup (all related data will be removed):
+   { "names": ["DeprecatedSystem"] }`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            names: {
+                type: 'array',
+                description: 'Array of node names to delete. Non-existent names will be ignored.',
+                items: { type: 'string' },
+            },
+        },
+        required: ['names'],
+    };
+    constructor(nodeService, factRepo, linkRepo) {
+        super();
+        this.nodeService = nodeService;
+        this.factRepo = factRepo;
+        this.linkRepo = linkRepo;
+    }
+    async execute(input) {
+        // Validate array parameters
+        this.validateArray(input.names, 'names', {
+            description: 'Provide an array of node names to delete',
+            example: '{"names": ["Alice", "Bob"]}',
+        });
+        const nodes = [];
+        for (const name of input.names) {
+            const node = await this.nodeService.findByName(name);
+            if (node) {
+                const factsCount = await this.factRepo.countByNodeId(node.id);
+                const links = await this.linkRepo.findByNodeId(node.id);
+                const linksCount = links.length;
+                nodes.push({ name: node.name, type: node.type, factsCount, linksCount });
+            }
+        }
+        const count = await this.nodeService.deleteNodesByNames(input.names);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        deleted: count,
+                        nodes: nodes.filter(n => input.names.includes(n.name)),
+                    }),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=NodeDelCommand.js.map

package/dist/interfaces/mcp/commands/NodeDelCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeDelCommand.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/NodeDelCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK/C,MAAM,OAAO,cAAe,SAAQ,WAAqB;IA0BpC;IACA;IACA;IA3BV,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG;;;;;;;;;;qCAUY,CAAC;IAC3B,WAAW,GAAG;QACrB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,oEAAoE;gBACjF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;IAEF,YACmB,WAAwB,EACxB,QAAwB,EACxB,QAAwB;QAEzC,KAAK,EAAE,CAAC;QAJS,gBAAW,GAAX,WAAW,CAAa;QACxB,aAAQ,GAAR,QAAQ,CAAgB;QACxB,aAAQ,GAAR,QAAQ,CAAgB;IAG3C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAU;QACtB,4BAA4B;QAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE;YACvC,WAAW,EAAE,0CAA0C;YACvD,OAAO,EAAE,6BAA6B;SACvC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAU,EAAE,CAAC;QAExB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC9D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAErE,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;qBACvD,CAAC;iBACH,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}

package/dist/interfaces/mcp/commands/NodeEditCommand.d.ts

@@ -0,0 +1,43 @@
+import { BaseCommand } from './BaseCommand.js';
+import type { NodeService } from '../../../application/services/NodeService.js';
+export declare class NodeEditCommand extends BaseCommand<any, any> {
+    private readonly nodeService;
+    readonly name = "kg_node_edit";
+    readonly description = "Edit existing node's name and/or type. You must provide the current name to identify the node, and at least one of newName or newType to update.\n\nExamples:\n1. Rename a node:\n   { \"nodes\": [{ \"name\": \"Alice\", \"newName\": \"Alice_Smith\" }] }\n\n2. Change node type:\n   { \"nodes\": [{ \"name\": \"TechCorp\", \"newType\": \"tech_company\" }] }\n\n3. Update both name and type:\n   { \"nodes\": [{ \"name\": \"OldProject\", \"newName\": \"NewProject\", \"newType\": \"active_project\" }] }";
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            nodes: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        name: {
+                            type: string;
+                            description: string;
+                        };
+                        newName: {
+                            type: string;
+                            description: string;
+                        };
+                        newType: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+    constructor(nodeService: NodeService);
+    execute(input: any): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=NodeEditCommand.d.ts.map

package/dist/interfaces/mcp/commands/NodeEditCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeEditCommand.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/NodeEditCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAEhF,qBAAa,eAAgB,SAAQ,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;IAiC5C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAhCxC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,yfAU4E;IAChG,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;MAkBlB;gBAE2B,WAAW,EAAE,WAAW;IAI/C,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CA0BvF"}

package/dist/interfaces/mcp/commands/NodeEditCommand.js

@@ -0,0 +1,63 @@
+import { BaseCommand } from './BaseCommand.js';
+export class NodeEditCommand extends BaseCommand {
+    nodeService;
+    name = 'kg_node_edit';
+    description = `Edit existing node's name and/or type. You must provide the current name to identify the node, and at least one of newName or newType to update.
+
+Examples:
+1. Rename a node:
+   { "nodes": [{ "name": "Alice", "newName": "Alice_Smith" }] }
+
+2. Change node type:
+   { "nodes": [{ "name": "TechCorp", "newType": "tech_company" }] }
+
+3. Update both name and type:
+   { "nodes": [{ "name": "OldProject", "newName": "NewProject", "newType": "active_project" }] }`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            nodes: {
+                type: 'array',
+                description: 'Array of nodes to edit. Each item must have "name" and at least one of "newName" or "newType".',
+                items: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Current name of the node to edit' },
+                        newName: { type: 'string', description: 'New name for the node (optional)' },
+                        newType: { type: 'string', description: 'New type for the node (optional)' },
+                    },
+                    required: ['name'],
+                },
+            },
+        },
+        required: ['nodes'],
+    };
+    constructor(nodeService) {
+        super();
+        this.nodeService = nodeService;
+    }
+    async execute(input) {
+        // Validate array parameters
+        this.validateArray(input.nodes, 'nodes', {
+            description: 'Provide an array of nodes to edit',
+            example: '{"nodes": [{"name": "Alice", "newName": "Alice_Smith"}]}',
+        });
+        // Map 'name' to 'nodeName' for NodeService
+        const updates = input.nodes.map((n) => ({
+            nodeName: n.name,
+            newName: n.newName,
+            newType: n.newType,
+        }));
+        const nodes = await this.nodeService.updateNodesByName(updates);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        updated: nodes.length,
+                        nodes: nodes.map(n => ({ name: n.name, type: n.type })),
+                    }),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=NodeEditCommand.js.map

package/dist/interfaces/mcp/commands/NodeEditCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeEditCommand.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/NodeEditCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,OAAO,eAAgB,SAAQ,WAAqB;IAiC3B;IAhCpB,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG;;;;;;;;;;iGAUwE,CAAC;IACvF,WAAW,GAAG;QACrB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,gGAAgG;gBAC7G,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;wBACzE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;wBAC5E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;qBAC7E;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;IAEF,YAA6B,WAAwB;QACnD,KAAK,EAAE,CAAC;QADmB,gBAAW,GAAX,WAAW,CAAa;IAErD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAU;QACtB,4BAA4B;QAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE;YACvC,WAAW,EAAE,mCAAmC;YAChD,OAAO,EAAE,0DAA0D;SACpE,CAAC,CAAC;QAEH,2CAA2C;QAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YAC3C,QAAQ,EAAE,CAAC,CAAC,IAAI;YAChB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC,CAAC;QAEJ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAEhE,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK,CAAC,MAAM;wBACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;qBACxD,CAAC;iBACH,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}

package/dist/interfaces/mcp/commands/NodeGetCommand.d.ts

@@ -0,0 +1,40 @@
+import { BaseCommand } from './BaseCommand.js';
+import type { KnowledgeGraphService } from '../../../application/services/KnowledgeGraphService.js';
+export declare class NodeGetCommand extends BaseCommand<any, any> {
+    private readonly kgService;
+    readonly name = "kg_node_get";
+    readonly description = "Retrieve specific nodes by their names. Returns the nodes with their facts and all links involving these nodes. Link endpoints that are not in the requested list will still have their names resolved.\n\nExamples:\n1. Get a single node:\n   { \"names\": [\"Alice\"], \"page\": false }\n\n2. Get multiple nodes:\n   { \"names\": [\"Alice\", \"Bob\", \"TechCorp\"], \"page\": false }\n\n3. Get with pagination:\n   { \"names\": [\"Alice\", \"Bob\", \"Charlie\", \"David\"], \"page\": true, \"pageNum\": 1, \"pageSize\": 2 }";
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            names: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                };
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+            pageNum: {
+                type: string;
+                description: string;
+            };
+            pageSize: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(kgService: KnowledgeGraphService);
+    execute(input: any): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=NodeGetCommand.d.ts.map

package/dist/interfaces/mcp/commands/NodeGetCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeGetCommand.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/NodeGetCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAEpG,qBAAa,cAAe,SAAQ,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;IA4B3C,OAAO,CAAC,QAAQ,CAAC,SAAS;IA3BtC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,8gBAU2E;IAC/F,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;MAalB;gBAE2B,SAAS,EAAE,qBAAqB;IAIvD,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CA0CvF"}

package/dist/interfaces/mcp/commands/NodeGetCommand.js

@@ -0,0 +1,72 @@
+import { BaseCommand } from './BaseCommand.js';
+export class NodeGetCommand extends BaseCommand {
+    kgService;
+    name = 'kg_node_get';
+    description = `Retrieve specific nodes by their names. Returns the nodes with their facts and all links involving these nodes. Link endpoints that are not in the requested list will still have their names resolved.
+
+Examples:
+1. Get a single node:
+   { "names": ["Alice"], "page": false }
+
+2. Get multiple nodes:
+   { "names": ["Alice", "Bob", "TechCorp"], "page": false }
+
+3. Get with pagination:
+   { "names": ["Alice", "Bob", "Charlie", "David"], "page": true, "pageNum": 1, "pageSize": 2 }`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            names: {
+                type: 'array',
+                description: 'Array of node names to retrieve',
+                items: { type: 'string' },
+            },
+            page: { type: 'boolean', description: 'Set to true to enable pagination, false to return all results' },
+            pageNum: { type: 'number', description: 'Page number (default: 1), only used when page=true' },
+            pageSize: { type: 'number', description: 'Number of nodes per page (default: 10), only used when page=true' },
+        },
+        required: ['names', 'page'],
+    };
+    constructor(kgService) {
+        super();
+        this.kgService = kgService;
+    }
+    async execute(input) {
+        // Validate array parameters
+        this.validateArray(input.names, 'names', {
+            description: 'Provide an array of node names to retrieve',
+            example: '{"names": ["Alice", "Bob"], "page": false}',
+        });
+        const enablePagination = input.page === true;
+        const pagination = enablePagination ? {
+            page: input.pageNum || 1,
+            pageSize: input.pageSize || 10,
+        } : undefined;
+        const result = await this.kgService.getByNames(input.names || [], pagination);
+        const output = {
+            nodes: result.data.nodes.map((n) => ({
+                name: n.name,
+                type: n.type,
+                facts: n.facts.map((f) => f.content),
+            })),
+            links: result.data.links.map((l) => ({
+                from: l.from,
+                to: l.to,
+                type: l.type,
+            })),
+        };
+        if (enablePagination) {
+            const info = result.pagination;
+            output.pagination = {
+                page: info.page,
+                pageSize: info.pageSize,
+                total: info.totalItems,
+                pages: info.totalPages,
+                hasNext: info.hasNextPage,
+                hasPrev: info.hasPrevPage,
+            };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(output) }] };
+    }
+}
+//# sourceMappingURL=NodeGetCommand.js.map

package/dist/interfaces/mcp/commands/NodeGetCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeGetCommand.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/NodeGetCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,OAAO,cAAe,SAAQ,WAAqB;IA4B1B;IA3BpB,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG;;;;;;;;;;gGAUuE,CAAC;IACtF,WAAW,GAAG;QACrB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,iCAAiC;gBAC9C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;YACD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,+DAA+D,EAAE;YACvG,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;YAC9F,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kEAAkE,EAAE;SAC9G;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;KAC5B,CAAC;IAEF,YAA6B,SAAgC;QAC3D,KAAK,EAAE,CAAC;QADmB,cAAS,GAAT,SAAS,CAAuB;IAE7D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAU;QACtB,4BAA4B;QAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE;YACvC,WAAW,EAAE,4CAA4C;YACzD,OAAO,EAAE,4CAA4C;SACtD,CAAC,CAAC;QAEH,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAC7C,MAAM,UAAU,GAAG,gBAAgB,CAAC,CAAC,CAAC;YACpC,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;SAC/B,CAAC,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;QAE9E,MAAM,MAAM,GAAQ;YAClB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBACxC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;YACH,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBACxC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC;SACJ,CAAC;QAEF,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;YAC/B,MAAM,CAAC,UAAU,GAAG;gBAClB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,UAAU;gBACtB,KAAK,EAAE,IAAI,CAAC,UAAU;gBACtB,OAAO,EAAE,IAAI,CAAC,WAAW;gBACzB,OAAO,EAAE,IAAI,CAAC,WAAW;aAC1B,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IACvE,CAAC;CACF"}

package/dist/interfaces/mcp/commands/SearchCommand.d.ts

@@ -0,0 +1,53 @@
+import { BaseCommand } from './BaseCommand.js';
+import type { KnowledgeGraphService } from '../../../application/services/KnowledgeGraphService.js';
+export declare class SearchCommand extends BaseCommand<any, any> {
+    private readonly kgService;
+    readonly name = "kg_search";
+    readonly description = "Search for nodes by keywords. You can search in node names, types, or facts. Supports OR logic (match any keyword) or AND logic (match all keywords). By default searches in name, type, and fact fields.\n\nExamples:\n1. Simple search (OR logic, any match):\n   { \"queries\": [\"Python\", \"engineer\"], \"page\": false }\n\n2. Search with AND logic (all keywords must match):\n   { \"queries\": [\"engineer\", \"Python\"], \"logic\": \"and\", \"page\": false }\n\n3. Search in specific fields:\n   { \"queries\": [\"works_at\"], \"fields\": [\"link\"], \"page\": false }\n\n4. Search with pagination:\n   { \"queries\": [\"engineer\"], \"fields\": [\"fact\"], \"page\": true, \"pageNum\": 1, \"pageSize\": 10 }";
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            queries: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+            pageNum: {
+                type: string;
+                description: string;
+            };
+            pageSize: {
+                type: string;
+                description: string;
+            };
+            logic: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            fields: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(kgService: KnowledgeGraphService);
+    execute(input: any): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=SearchCommand.d.ts.map

package/dist/interfaces/mcp/commands/SearchCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchCommand.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/SearchCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAEpG,qBAAa,aAAc,SAAQ,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;IAyC1C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAxCtC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,4sBAa0E;IAC9F,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAuBlB;gBAE2B,SAAS,EAAE,qBAAqB;IAIvD,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAqDvF"}

package/dist/interfaces/mcp/commands/SearchCommand.js

@@ -0,0 +1,91 @@
+import { BaseCommand } from './BaseCommand.js';
+export class SearchCommand extends BaseCommand {
+    kgService;
+    name = 'kg_search';
+    description = `Search for nodes by keywords. You can search in node names, types, or facts. Supports OR logic (match any keyword) or AND logic (match all keywords). By default searches in name, type, and fact fields.
+
+Examples:
+1. Simple search (OR logic, any match):
+   { "queries": ["Python", "engineer"], "page": false }
+
+2. Search with AND logic (all keywords must match):
+   { "queries": ["engineer", "Python"], "logic": "and", "page": false }
+
+3. Search in specific fields:
+   { "queries": ["works_at"], "fields": ["link"], "page": false }
+
+4. Search with pagination:
+   { "queries": ["engineer"], "fields": ["fact"], "page": true, "pageNum": 1, "pageSize": 10 }`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            queries: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Array of search keywords. Case-insensitive partial matching.'
+            },
+            page: { type: 'boolean', description: 'Set to true to enable pagination, false to return all results' },
+            pageNum: { type: 'number', description: 'Page number (default: 1), only used when page=true' },
+            pageSize: { type: 'number', description: 'Number of nodes per page (default: 10), only used when page=true' },
+            logic: {
+                type: 'string',
+                enum: ['or', 'and'],
+                description: 'Search logic: "or" matches any keyword, "and" matches all keywords (default: "or")'
+            },
+            fields: {
+                type: 'array',
+                items: { type: 'string', enum: ['name', 'type', 'link', 'fact'] },
+                description: 'Fields to search in: name, type, link (relationship types), fact (fact content). Default: ["name", "type", "fact"].'
+            },
+        },
+        required: ['queries', 'page'],
+    };
+    constructor(kgService) {
+        super();
+        this.kgService = kgService;
+    }
+    async execute(input) {
+        // Validate array parameters
+        this.validateArray(input.queries, 'queries', {
+            description: 'Provide an array of search keywords',
+            example: '{"queries": ["keyword1", "keyword2"], "page": false}',
+        });
+        if (input.fields !== undefined) {
+            this.validateArray(input.fields, 'fields', {
+                description: 'Provide an array of field names to search in',
+                example: '{"queries": ["test"], "fields": ["name", "type"], "page": false}',
+            });
+        }
+        const enablePagination = input.page === true;
+        const pagination = enablePagination ? {
+            page: input.pageNum || 1,
+            pageSize: input.pageSize || 10,
+        } : undefined;
+        const result = await this.kgService.search(input.queries || [], input.logic || 'or', input.fields, pagination);
+        const output = {
+            nodes: result.data.nodes.map((n) => ({
+                name: n.name,
+                type: n.type,
+                facts: n.facts.map((f) => f.content),
+            })),
+            links: result.data.links.map((l) => ({
+                from: l.from,
+                to: l.to,
+                type: l.type,
+            })),
+        };
+        if (enablePagination) {
+            const info = result.pagination;
+            output.pagination = {
+                page: info.page,
+                pageSize: info.pageSize,
+                total: info.totalItems,
+                pages: info.totalPages,
+                hasNext: info.hasNextPage,
+                hasPrev: info.hasPrevPage,
+            };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(output) }] };
+    }
+}
+//# sourceMappingURL=SearchCommand.js.map

package/dist/interfaces/mcp/commands/SearchCommand.js.map

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

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name":"@chinjinyu/mcp-knowledge-graph-plus",
+  "version":"0.1.1",
+  "description":"MCP server for persistent AI memory using SQLite database with knowledge graph",
+  "license":"MIT",
+  "type":"module",
+  "engines":{"node":">=18.0.0"},
+  "publishConfig": {
+    "access": "public"
+  },"bin":{"mcp-knowledge-graph-plus":"dist/index.js"},"files":["dist"],"scripts":{"build":"tsc && shx chmod +x dist/*.js","preinstall":"npm run build","watch":"tsc --watch","test":"node --experimental-vm-modules node_modules/jest/bin/jest.js","test:watch":"node --experimental-vm-modules node_modules/jest/bin/jest.js --watch","test:coverage":"node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage","test:ci":"node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage --ci"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.1","sqlite3":"^5.1.7"},"devDependencies":{"@types/better-sqlite3":"^7.6.12","@types/jest":"^30.0.0","@types/minimist":"^1.2.5","@types/node":"^22.9.3","jest":"^30.2.0","shx":"^0.3.4","ts-jest":"^29.4.6","typescript":"^5.6.2"}}