@henrychong-ai/mcp-neo4j-knowledge-graph 1.0.0

package/dist/server/handlers/toolHandlers/createEntities.js

@@ -0,0 +1,20 @@
+/**
+ * Handles the create_entities tool request
+ * @param args The arguments for the tool request
+ * @param knowledgeGraphManager The KnowledgeGraphManager instance
+ * @returns A response object with the result content
+ */
+export async function handleCreateEntities(args, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+knowledgeGraphManager) {
+    const result = await knowledgeGraphManager.createEntities(args.entities);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=createEntities.js.map

package/dist/server/handlers/toolHandlers/createEntities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEntities.js","sourceRoot":"","sources":["../../../../src/server/handlers/toolHandlers/createEntities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAA6B;AAC7B,8DAA8D;AAC9D,qBAA0B;IAE1B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server/handlers/toolHandlers/createRelations.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Handles the create_relations tool request
+ * @param args The arguments for the tool request
+ * @param knowledgeGraphManager The KnowledgeGraphManager instance
+ * @returns A response object with the result content
+ */
+export declare function handleCreateRelations(args: Record<string, unknown>, knowledgeGraphManager: any): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;

package/dist/server/handlers/toolHandlers/createRelations.js

@@ -0,0 +1,20 @@
+/**
+ * Handles the create_relations tool request
+ * @param args The arguments for the tool request
+ * @param knowledgeGraphManager The KnowledgeGraphManager instance
+ * @returns A response object with the result content
+ */
+export async function handleCreateRelations(args, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+knowledgeGraphManager) {
+    const result = await knowledgeGraphManager.createRelations(args.relations);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=createRelations.js.map

package/dist/server/handlers/toolHandlers/createRelations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRelations.js","sourceRoot":"","sources":["../../../../src/server/handlers/toolHandlers/createRelations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAA6B;AAC7B,8DAA8D;AAC9D,qBAA0B;IAE1B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3E,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server/handlers/toolHandlers/deleteEntities.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Handles the delete_entities tool request
+ * @param args The arguments for the tool request
+ * @param knowledgeGraphManager The KnowledgeGraphManager instance
+ * @returns A response object with the success message
+ */
+export declare function handleDeleteEntities(args: Record<string, unknown>, knowledgeGraphManager: any): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;

package/dist/server/handlers/toolHandlers/deleteEntities.js

@@ -0,0 +1,20 @@
+/**
+ * Handles the delete_entities tool request
+ * @param args The arguments for the tool request
+ * @param knowledgeGraphManager The KnowledgeGraphManager instance
+ * @returns A response object with the success message
+ */
+export async function handleDeleteEntities(args, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+knowledgeGraphManager) {
+    await knowledgeGraphManager.deleteEntities(args.entityNames);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: 'Entities deleted successfully',
+            },
+        ],
+    };
+}
+//# sourceMappingURL=deleteEntities.js.map

package/dist/server/handlers/toolHandlers/deleteEntities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteEntities.js","sourceRoot":"","sources":["../../../../src/server/handlers/toolHandlers/deleteEntities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAA6B;AAC7B,8DAA8D;AAC9D,qBAA0B;IAE1B,MAAM,qBAAqB,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7D,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,+BAA+B;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server/handlers/toolHandlers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Exports all tool handlers
+ */
+export { handleReadGraph } from './readGraph.js';
+export { handleCreateEntities } from './createEntities.js';
+export { handleCreateRelations } from './createRelations.js';
+export { handleAddObservations } from './addObservations.js';
+export { handleDeleteEntities } from './deleteEntities.js';

package/dist/server/handlers/toolHandlers/index.js

@@ -0,0 +1,9 @@
+/**
+ * Exports all tool handlers
+ */
+export { handleReadGraph } from './readGraph.js';
+export { handleCreateEntities } from './createEntities.js';
+export { handleCreateRelations } from './createRelations.js';
+export { handleAddObservations } from './addObservations.js';
+export { handleDeleteEntities } from './deleteEntities.js';
+//# sourceMappingURL=index.js.map

package/dist/server/handlers/toolHandlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/handlers/toolHandlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/server/handlers/toolHandlers/readGraph.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Handles the read_graph tool request
+ * @param args The arguments for the tool request
+ * @param knowledgeGraphManager The KnowledgeGraphManager instance
+ * @returns A response object with the result content
+ */
+export declare function handleReadGraph(args: Record<string, unknown>, knowledgeGraphManager: any): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;

package/dist/server/handlers/toolHandlers/readGraph.js

@@ -0,0 +1,20 @@
+/**
+ * Handles the read_graph tool request
+ * @param args The arguments for the tool request
+ * @param knowledgeGraphManager The KnowledgeGraphManager instance
+ * @returns A response object with the result content
+ */
+export async function handleReadGraph(args, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+knowledgeGraphManager) {
+    const result = await knowledgeGraphManager.readGraph();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=readGraph.js.map

package/dist/server/handlers/toolHandlers/readGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readGraph.js","sourceRoot":"","sources":["../../../../src/server/handlers/toolHandlers/readGraph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAA6B;AAC7B,8DAA8D;AAC9D,qBAA0B;IAE1B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,SAAS,EAAE,CAAC;IACvD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server/setup.d.ts

@@ -0,0 +1,8 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Sets up and configures the MCP server with the appropriate request handlers.
+ *
+ * @param knowledgeGraphManager The KnowledgeGraphManager instance to use for request handling
+ * @returns The configured server instance
+ */
+export declare function setupServer(knowledgeGraphManager: any): Server;

package/dist/server/setup.js

@@ -0,0 +1,48 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { handleListToolsRequest } from './handlers/listToolsHandler.js';
+import { handleCallToolRequest } from './handlers/callToolHandler.js';
+/**
+ * Sets up and configures the MCP server with the appropriate request handlers.
+ *
+ * @param knowledgeGraphManager The KnowledgeGraphManager instance to use for request handling
+ * @returns The configured server instance
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function setupServer(knowledgeGraphManager) {
+    // Create server instance
+    const server = new Server({
+        name: 'memento-mcp',
+        version: '1.0.0',
+        description: 'Memento MCP: Your persistent knowledge graph memory system',
+        publisher: 'gannonh',
+    }, {
+        capabilities: {
+            tools: {},
+            serverInfo: {}, // Add this capability to fix the error
+            notifications: {}, // Add this capability for complete support
+            logging: {}, // Add this capability for complete support
+        },
+    });
+    // Register request handlers
+    server.setRequestHandler(ListToolsRequestSchema, async (_request) => {
+        try {
+            const result = await handleListToolsRequest();
+            return result;
+        }
+        catch (error) {
+            throw error;
+        }
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        try {
+            const result = await handleCallToolRequest(request, knowledgeGraphManager);
+            return result;
+        }
+        catch (error) {
+            throw error;
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=setup.js.map

package/dist/server/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/server/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;;;;GAKG;AACH,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,qBAA0B;IACpD,yBAAyB;IACzB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,4DAA4D;QACzE,SAAS,EAAE,SAAS;KACrB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,EAAE,EAAE,uCAAuC;YACvD,aAAa,EAAE,EAAE,EAAE,2CAA2C;YAC9D,OAAO,EAAE,EAAE,EAAE,2CAA2C;SACzD;KACF,CACF,CAAC;IAEF,4BAA4B;IAC5B,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;QAClE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,EAAE,CAAC;YAC9C,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;YAC3E,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/storage/FileStorageProvider.d.ts

@@ -0,0 +1,125 @@
+import type { StorageProvider, SearchOptions } from './StorageProvider.js';
+import * as fs from 'fs';
+import type { KnowledgeGraph, Relation } from '../KnowledgeGraphManager.js';
+import type { VectorStoreFactoryOptions } from './VectorStoreFactory.js';
+interface FileStorageProviderOptions {
+    memoryFilePath?: string;
+    filePath?: string;
+    vectorStoreOptions?: VectorStoreFactoryOptions;
+}
+/**
+ * A storage provider that uses the file system to store the knowledge graph
+ * @deprecated This storage provider is deprecated and will be removed in a future version.
+ * Please migrate to SqliteStorageProvider.
+ */
+export declare class FileStorageProvider implements StorageProvider {
+    private _fs;
+    private filePath;
+    private graph;
+    private vectorStoreOptions?;
+    /**
+     * Create a new FileStorageProvider
+     * @param options Configuration options for the file storage provider
+     * @deprecated This storage provider is deprecated and will be removed in a future version.
+     * Please migrate to SqliteStorageProvider.
+     */
+    constructor(options?: FileStorageProviderOptions);
+    /**
+     * Set the fs module (for testing purposes)
+     */
+    setFs(fsModule: typeof fs): void;
+    /**
+     * Load the entire knowledge graph from the file
+     * @returns Promise resolving to the loaded KnowledgeGraph
+     */
+    loadGraph(): Promise<KnowledgeGraph>;
+    /**
+     * Save the entire knowledge graph to the file
+     * @param graph The KnowledgeGraph to save
+     * @returns Promise that resolves when the save is complete
+     */
+    saveGraph(graph: KnowledgeGraph): Promise<void>;
+    /**
+     * Search for nodes in the graph that match the query
+     * @param query The search query string
+     * @param options Optional search parameters
+     * @returns Promise resolving to a KnowledgeGraph containing matching nodes
+     */
+    searchNodes(query: string, options?: SearchOptions): Promise<KnowledgeGraph>;
+    /**
+     * Open specific nodes by their exact names
+     * @param names Array of node names to open
+     * @returns Promise resolving to a KnowledgeGraph containing the specified nodes
+     */
+    openNodes(names: string[]): Promise<KnowledgeGraph>;
+    /**
+     * Create new relations between entities
+     * @param relations Array of relations to create
+     * @returns Promise resolving to array of newly created relations
+     */
+    createRelations(relations: Relation[]): Promise<Relation[]>;
+    /**
+     * Add observations to entities
+     * @param observations Array of observations to add
+     * @returns Promise resolving to array of added observations
+     */
+    addObservations(observations: {
+        entityName: string;
+        contents: string[];
+    }[]): Promise<{
+        entityName: string;
+        addedObservations: string[];
+    }[]>;
+    /**
+     * Delete entities and their relations from the knowledge graph
+     * @param entityNames Array of entity names to delete
+     * @returns Promise that resolves when deletion is complete
+     */
+    deleteEntities(entityNames: string[]): Promise<void>;
+    /**
+     * Delete specific observations from entities
+     * @param deletions Array of objects with entity name and observations to delete
+     * @returns Promise that resolves when deletion is complete
+     */
+    deleteObservations(deletions: {
+        entityName: string;
+        observations: string[];
+    }[]): Promise<void>;
+    /**
+     * Delete relations from the graph
+     * @param relations Array of relations to delete
+     * @returns Promise that resolves when deletion is complete
+     * @deprecated FileStorageProvider is deprecated. Use SqliteStorageProvider instead.
+     */
+    deleteRelations(relations: Relation[]): Promise<void>;
+    /**
+     * Get a specific relation by its identifying properties
+     * @param from Source entity name
+     * @param to Target entity name
+     * @param relationType Type of relation
+     * @returns Promise resolving to the relation or null if not found
+     */
+    getRelation(from: string, to: string, relationType: string): Promise<Relation | null>;
+    /**
+     * Update an existing relation with new properties
+     * @param relation The relation with updated properties (from, to, and relationType identify the relation)
+     * @returns Promise that resolves when the update is complete
+     * @throws Error if the relation doesn't exist
+     */
+    updateRelation(relation: Relation): Promise<void>;
+    /**
+     * Create new entities in the knowledge graph
+     * @param entities Array of entities to create
+     * @returns Promise resolving to the array of created entities with timestamps
+     * @deprecated FileStorageProvider is deprecated. Use SqliteStorageProvider instead.
+     */
+    createEntities(entities: any[]): Promise<any[]>;
+    /**
+     * Get an entity by name
+     * @param entityName Name of the entity to retrieve
+     * @returns Promise resolving to the entity or null if not found
+     * @deprecated FileStorageProvider is deprecated. Use SqliteStorageProvider instead.
+     */
+    getEntity(entityName: string): Promise<any | null>;
+}
+export {};