@datafrog-io/n2n-memory 1.2.0 → 1.2.2

package/llms.txt

@@ -0,0 +1,83 @@
+# n2n-memory
+
+> Project-local MCP memory server for AI coding agents.
+
+n2n-memory is an open-source Model Context Protocol (MCP) server that stores AI coding memory inside each project repository. It prevents cross-project memory pollution by keeping durable project knowledge in `.mcp/memory.json` and active task context in `.mcp/context.json`.
+
+## Search intent coverage
+
+- AI coding memory server
+- project-local memory graph
+- MCP server for AI coding agents
+- local-first context storage
+- repository-scoped memory for Claude/Cursor/VS Code
+
+## What it is
+
+- A local-first MCP memory server for AI coding assistants.
+- A Git-friendly project knowledge graph stored as JSON.
+- A tool-agnostic memory layer for Claude Desktop, Cursor, VS Code MCP clients, and other stdio MCP-compatible tools.
+- A practical AI developer tool built for multi-project software development.
+
+## Use cases
+
+- Restore project context at the start of an AI coding session.
+- Preserve architecture decisions, implementation notes, pitfalls, and active task state.
+- Share durable AI project memory with a team through Git.
+- Avoid memory pollution from global AI assistant memory stores.
+- Query a project-local knowledge graph through MCP tools.
+
+## Not for
+
+- Cloud memory synchronization.
+- Global personal memory across unrelated projects.
+- Replacing source code search, static analysis, or repository maps.
+- Replacing a vector database or semantic retrieval platform.
+
+## Disambiguation
+
+This project is an MCP memory server. It is not related to any network/VPN software named `n2n`.
+
+## Storage model
+
+- `.mcp/memory.json`: durable knowledge graph with entities, observations, and relations.
+- `.mcp/context.json`: hot task context with active task, status, next steps, and update time.
+- Existing unreadable JSON files are treated as data integrity errors.
+- Exported files must stay inside the project root.
+
+## Install
+
+```bash
+npx -y @datafrog-io/n2n-memory
+```
+
+## Primary MCP tools
+
+- `n2n_read_graph`
+- `n2n_get_graph_summary`
+- `n2n_add_entities`
+- `n2n_add_observations`
+- `n2n_create_relations`
+- `n2n_update_context`
+- `n2n_search`
+- `n2n_open_nodes`
+- `n2n_delete_entities`
+- `n2n_delete_observations`
+- `n2n_delete_relations`
+- `n2n_export_markdown`
+
+## Key docs
+
+- `README.md`: overview, setup, workflow, FAQ.
+- `docs/API_REFERENCE.md`: full MCP tool reference.
+- `docs/DESIGN.md`: architecture and storage design.
+- `docs/DEVELOPMENT.md`: development, testing, CI, publishing.
+- `CHANGELOG.md`: release history.
+
+## Package and repository
+
+- npm: `@datafrog-io/n2n-memory`
+- GitHub: `https://github.com/n2ns/n2n-memory`
+- License: MIT
+
+Built by N2NS Lab, the open-source lab from Datafrog, focused on practical AI developer tools.

package/package.json

@@ -1,29 +1,73 @@
 {
   "name": "@datafrog-io/n2n-memory",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Project-local knowledge-graph memory MCP server for AI context isolation.",
   "main": "build/index.js",
   "bin": {
     "n2n-memory": "build/index.js"
   },
-  "repository": "n2ns/n2n-memory",
+  "files": [
+    "build",
+    "docs",
+    "README.md",
+    "llms.txt",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/n2ns/n2n-memory.git"
+  },
+  "homepage": "https://github.com/n2ns/n2n-memory#readme",
+  "bugs": {
+    "url": "https://github.com/n2ns/n2n-memory/issues"
+  },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "type": "module",
   "scripts": {
-    "build": "tsc",
+    "clean": "node -e \"require('node:fs').rmSync('build', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
     "start": "node build/index.js",
     "dev": "tsx src/index.ts",
-    "test": "mocha --node-option import=tsx src/test/**/*.test.ts",
-    "lint": "eslint src/**/*.ts"
+    "test": "vitest run",
+    "lint": "eslint src/**/*.ts",
+    "audit": "npm audit",
+    "audit:prod": "npm audit --omit=dev",
+    "pack:dry-run": "npm pack --dry-run",
+    "check": "npm run lint && npm test && npm run build && npm run audit && npm run pack:dry-run",
+    "prepublishOnly": "npm run check"
   },
   "keywords": [
     "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "modelcontextprotocol",
     "memory",
+    "agent-memory",
+    "ai-memory",
+    "project-memory",
+    "project-local-memory",
+    "project-local-knowledge-graph",
+    "mcp-memory-server",
+    "coding-agent-memory",
+    "repository-memory",
+    "repository-context",
+    "context-memory",
+    "local-first-memory",
+    "coding-assistant-memory",
+    "project-memory-server",
     "context",
     "ai",
+    "ai-developer-tools",
+    "coding-agent",
+    "local-first",
+    "claude",
+    "claude-desktop",
+    "cursor",
+    "vscode",
     "knowledge-graph"
   ],
   "author": "DataFrog IO",
@@ -33,28 +77,26 @@
     "npm": ">=10.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@types/proper-lockfile": "^4.1.4",
     "async-mutex": "^0.5.0",
-    "fs-extra": "^11.3.3",
+    "fs-extra": "^11.3.5",
     "proper-lockfile": "^4.1.2",
-    "zod": "^4.2.1"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/chai": "^5.2.3",
     "@types/fs-extra": "^11.0.4",
-    "@types/mocha": "^10.0.10",
     "@types/node": "^25.0.3",
     "@types/sinon": "^21.0.0",
     "@typescript-eslint/eslint-plugin": "^8.50.0",
     "@typescript-eslint/parser": "^8.50.0",
     "chai": "^6.2.1",
     "eslint": "^9.39.2",
-    "mocha": "^11.7.5",
     "sinon": "^21.0.1",
-    "ts-node": "^10.9.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.0"
+    "typescript-eslint": "^8.50.0",
+    "vitest": "^4.1.8"
   }
-}
+}