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

package/dist/types/vector-store.d.ts

@@ -0,0 +1,16 @@
+export interface VectorSearchResult {
+    id: string | number;
+    similarity: number;
+    metadata: Record<string, any>;
+}
+export interface VectorStore {
+    initialize(): Promise<void>;
+    addVector(id: string | number, vector: number[], metadata?: Record<string, any>): Promise<void>;
+    removeVector(id: string | number): Promise<void>;
+    search(queryVector: number[], options?: {
+        limit?: number;
+        filter?: Record<string, any>;
+        hybridSearch?: boolean;
+        minSimilarity?: number;
+    }): Promise<VectorSearchResult[]>;
+}

package/dist/types/vector-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vector-store.js.map

package/dist/types/vector-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.js","sourceRoot":"","sources":["../../src/types/vector-store.ts"],"names":[],"mappings":""}

package/dist/utils/fs.d.ts

@@ -0,0 +1,2 @@
+import { promises as fs } from 'fs';
+export { fs };

package/dist/utils/fs.js

@@ -0,0 +1,3 @@
+import { promises as fs } from 'fs';
+export { fs };
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Simple logger utility that wraps console methods
+ * Avoids direct console usage which can interfere with MCP stdio
+ */
+export declare const logger: {
+    info: (message: string, ...args: any[]) => void;
+    error: (message: string, error?: any) => void;
+    debug: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+};

package/dist/utils/logger.js

@@ -0,0 +1,35 @@
+/**
+ * Simple logger utility that wraps console methods
+ * Avoids direct console usage which can interfere with MCP stdio
+ */
+export const logger = {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    info: (message, ...args) => {
+        process.stderr.write(`[INFO] ${message}\n`);
+        if (args.length > 0) {
+            process.stderr.write(`${JSON.stringify(args, null, 2)}\n`);
+        }
+    },
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    error: (message, error) => {
+        process.stderr.write(`[ERROR] ${message}\n`);
+        if (error) {
+            process.stderr.write(`${error instanceof Error ? error.stack : JSON.stringify(error, null, 2)}\n`);
+        }
+    },
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    debug: (message, ...args) => {
+        process.stderr.write(`[DEBUG] ${message}\n`);
+        if (args.length > 0) {
+            process.stderr.write(`${JSON.stringify(args, null, 2)}\n`);
+        }
+    },
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    warn: (message, ...args) => {
+        process.stderr.write(`[WARN] ${message}\n`);
+        if (args.length > 0) {
+            process.stderr.write(`${JSON.stringify(args, null, 2)}\n`);
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,8DAA8D;IAC9D,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,KAAK,EAAE,CAAC,OAAe,EAAE,KAAW,EAAE,EAAE;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;QAC7C,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@henrychong-ai/mcp-neo4j-knowledge-graph",
+  "version": "1.0.0",
+  "description": "Neo4j-based knowledge graph MCP server (fork of @gannonh/memento-mcp with bug fixes)",
+  "license": "MIT",
+  "author": "Gannon Hall (original), Henry Chong (fork maintainer)",
+  "homepage": "https://github.com/henrychong-ai/mcp-neo4j-knowledge-graph",
+  "bugs": "https://github.com/henrychong-ai/mcp-neo4j-knowledge-graph/issues",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-neo4j-knowledge-graph": "dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/henrychong-ai/mcp-neo4j-knowledge-graph.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "neo4j",
+    "knowledge-graph",
+    "memory",
+    "llm",
+    "ai",
+    "claude"
+  ],
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "prepare": "npm run build",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:verbose": "clear && vitest run --reporter verbose",
+    "test:integration": "TEST_INTEGRATION=true npm test",
+    "lint": "eslint 'src/**/*.ts'",
+    "lint:fix": "eslint 'src/**/*.ts' --fix",
+    "format": "prettier --write \"**/*.{ts,json,md}\"",
+    "fix": "npm run lint:fix && npm run format",
+    "neo4j:init": "tsx src/cli/neo4j-setup.ts init",
+    "neo4j:test": "tsx src/cli/neo4j-setup.ts test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.11.0",
+    "axios": "^1.8.4",
+    "dotenv": "^16.4.7",
+    "lru-cache": "^11.1.0",
+    "neo4j-driver": "^5.28.1",
+    "openai": "^4.90.0",
+    "ts-node": "^10.9.2",
+    "uuid": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/lru-cache": "^7.10.10",
+    "@types/node": "^22",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.28.0",
+    "@typescript-eslint/parser": "^8.28.0",
+    "@vitest/coverage-v8": "^3.1.1",
+    "eslint": "^9.23.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-prettier": "^5.4.0",
+    "glob": "^11.0.1",
+    "prettier": "^3.5.3",
+    "rimraf": "^6.0.1",
+    "shx": "^0.4.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.32.0",
+    "vitest": "^3.1.1",
+    "zod": "^3.24.2"
+  },
+  "overrides": {
+    "glob": "^11.0.1",
+    "rimraf": "^6.0.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}