{"_id":"ainative-memory-mcp","_rev":"3-f9852671909554177f63dd2594991f87","name":"ainative-memory-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"ainative-memory-mcp","version":"1.0.0","keywords":["mcp","mcp-server","mcp-server-hosting","model-context-protocol","model-context-protocol-server","modelcontextprotocol","knowledge-graph","memory-server","persistent-memory","cloud-memory","server-memory-alternative","server-memory","memory","graph-memory","knowledge-base","entity-relations","semantic-search","vector-search","vector-database","embeddings","ainative","zerodb","zeromemory","ai-agents","agentic-ai","ai-tool-calling","agent-memory","claude","claude-code","claude-desktop","claude-ai-agents","windsurf","cursor","codex","n8n-ai","production-ready","composio-alternative","auto-provisioning","free-tier","cloud-persistence","cross-device","shared-memory","drop-in-replacement"],"author":{"url":"https://ainative.studio","name":"AINative Studio","email":"toby@rely.ventures"},"license":"MIT","_id":"ainative-memory-mcp@1.0.0","maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"homepage":"https://github.com/AINative-Studio/ainative-memory-mcp#readme","bugs":{"url":"https://github.com/AINative-Studio/ainative-memory-mcp/issues"},"bin":{"ainative-memory-mcp":"index.js"},"dist":{"shasum":"cc01b89fd020e448002d683e6cf0ff069cb4d776","tarball":"https://registry.npmjs.org/ainative-memory-mcp/-/ainative-memory-mcp-1.0.0.tgz","fileCount":6,"integrity":"sha512-Jh8N7bgMskQz1pbCBkxguZZM+MrpIueK4kUJwvr9l836rX1C3XoU9qBj44q/p8TOzJ2hHUpVk+SC++/giSReaA==","signatures":[{"sig":"MEUCIQCR4cgFZG7MQxppL+o1fZVF+eoWo6ZHn2oPYBHtVBmPYAIgTj2oCQ8f0RArC7U6uKHY4d4GhCU9rYYmAKf2XTbC/gY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42780},"main":"index.js","type":"module","engines":{"npm":">=9.0.0","node":">=18.0.0"},"gitHead":"e8a3dd779f5e5ee6935dc496c35956ba3036f7b3","scripts":{"test":"node --test tests/*.test.js","start":"node index.js"},"_npmUser":{"name":"ainative-studio","email":"toby@rely.ventures"},"repository":{"url":"git+https://github.com/AINative-Studio/ainative-memory-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Enhanced MCP server-memory with ZeroDB cloud persistence and semantic vector search. Drop-in replacement for @modelcontextprotocol/server-memory that stores your knowledge graph in the cloud instead of local JSONL files.","directories":{},"_nodeVersion":"22.21.0","dependencies":{"axios":"^1.7.7","dotenv":"^16.4.0","@modelcontextprotocol/sdk":"^1.24.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ainative-memory-mcp_1.0.0_1781077788214_0.15132226881864486","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"ainative-memory-mcp","version":"1.0.1","keywords":["mcp","mcp-server","mcp-server-hosting","model-context-protocol","model-context-protocol-server","modelcontextprotocol","knowledge-graph","memory-server","persistent-memory","cloud-memory","server-memory-alternative","server-memory","memory","graph-memory","knowledge-base","entity-relations","semantic-search","vector-search","vector-database","embeddings","ainative","zerodb","zeromemory","ai-agents","agentic-ai","ai-tool-calling","agent-memory","claude","claude-code","claude-desktop","claude-ai-agents","windsurf","cursor","codex","n8n-ai","production-ready","composio-alternative","auto-provisioning","free-tier","cloud-persistence","cross-device","shared-memory","drop-in-replacement"],"author":{"url":"https://ainative.studio","name":"AINative Studio","email":"toby@rely.ventures"},"license":"MIT","_id":"ainative-memory-mcp@1.0.1","maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"homepage":"https://github.com/AINative-Studio/ainative-memory-mcp#readme","bugs":{"url":"https://github.com/AINative-Studio/ainative-memory-mcp/issues"},"bin":{"ainative-memory-mcp":"index.js"},"dist":{"shasum":"89d9cfefd9c951fd54baf0714c1eb022778dad68","tarball":"https://registry.npmjs.org/ainative-memory-mcp/-/ainative-memory-mcp-1.0.1.tgz","fileCount":6,"integrity":"sha512-3P0+lzINeYd+wgg+QxSZC1Ijsf++nm3VPul2kKpV2yHP7sEeyy/fHX4ue2U3qwRsoUpzLPR4JLCl8SUgl2k8HQ==","signatures":[{"sig":"MEQCIHd11wSGXxeww+Ajn7nMCbYgkv09sjgN/Xss0ktiR7pqAiBCQI+Q5waNw4MjnqEM/pRJ9HjabeLCUR4nSX+BJilZeQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44611},"main":"index.js","type":"module","engines":{"npm":">=9.0.0","node":">=18.0.0"},"gitHead":"ac6f20b67de2a4d94c2c1a377289eada67c723de","mcpName":"io.github.AINative-Studio/ainative-memory-mcp","scripts":{"test":"node --test tests/*.test.js","start":"node index.js"},"_npmUser":{"name":"ainative-studio","email":"toby@rely.ventures"},"repository":{"url":"git+https://github.com/AINative-Studio/ainative-memory-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Enhanced MCP server-memory with ZeroDB cloud persistence and semantic vector search. Drop-in replacement for @modelcontextprotocol/server-memory that stores your knowledge graph in the cloud instead of local JSONL files.","directories":{},"_nodeVersion":"22.21.0","dependencies":{"axios":"^1.7.7","dotenv":"^16.4.0","@modelcontextprotocol/sdk":"^1.24.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ainative-memory-mcp_1.0.1_1785551071649_0.7611388942962145","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"_id":"ainative-memory-mcp@1.0.2","bin":{"ainative-memory-mcp":"index.js"},"bugs":{"url":"https://github.com/AINative-Studio/ainative-memory-mcp/issues"},"dist":{"shasum":"6d69afc70e99f4ab8130df1fa63b2f49f435bd5c","tarball":"https://registry.npmjs.org/ainative-memory-mcp/-/ainative-memory-mcp-1.0.2.tgz","fileCount":6,"integrity":"sha512-jpWtwlWVTeZqhZcg/qCv8TaqJKqLxL3RDLnj1VKodejeYNAT+H9jhFLCCWELOGbupEVk547qrWrYsYagIRFS0g==","signatures":[{"sig":"MEYCIQCg4TfFmFu2WgIk0nBl9YvnkG5A42MXap+Gwm9ypoJCcAIhALmjwiYWBn3MmTdDzim93BNFSIu1gPbIWAsnPJ6gpf1X","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC97u+SHIuEe/PhZitOWk5tctHNFDb4LiF2RcBQ/a8qegIhAPpbUrjIMOMOSFAZYqTlHAzbnA7XgUJ9k3HAIeAAyFoP"}],"unpackedSize":44590},"main":"index.js","name":"ainative-memory-mcp","type":"module","author":{"url":"https://ainative.studio","name":"AINative Studio","email":"toby@rely.ventures"},"engines":{"npm":">=9.0.0","node":">=18.0.0"},"gitHead":"016792bd4a894345eb4c89f8d271aabe8338bb08","license":"MIT","mcpName":"io.github.AINative-Studio/ainative-memory-mcp","scripts":{"test":"node --test tests/*.test.js","start":"node index.js"},"version":"1.0.2","_npmUser":{"name":"ainative-studio","email":"toby@rely.ventures"},"homepage":"https://ainative.studio/agent-memory-api","keywords":["mcp","mcp-server","mcp-server-hosting","model-context-protocol","model-context-protocol-server","modelcontextprotocol","knowledge-graph","memory-server","persistent-memory","cloud-memory","server-memory-alternative","server-memory","memory","graph-memory","knowledge-base","entity-relations","semantic-search","vector-search","vector-database","embeddings","ainative","zerodb","zeromemory","ai-agents","agentic-ai","ai-tool-calling","agent-memory","claude","claude-code","claude-desktop","claude-ai-agents","windsurf","cursor","codex","n8n-ai","production-ready","composio-alternative","auto-provisioning","free-tier","cloud-persistence","cross-device","shared-memory","drop-in-replacement"],"repository":{"url":"git+https://github.com/AINative-Studio/ainative-memory-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Enhanced MCP server-memory with ZeroDB cloud persistence and semantic vector search. Drop-in replacement for @modelcontextprotocol/server-memory that stores your knowledge graph in the cloud instead of local JSONL files.","directories":{},"maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"_nodeVersion":"22.21.0","dependencies":{"axios":"^1.7.7","dotenv":"^16.4.0","@modelcontextprotocol/sdk":"^1.24.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ainative-memory-mcp_1.0.2_1790310485339_0.6913864860477568"}}},"time":{"created":"2026-06-10T07:49:48.130Z","modified":"2026-09-25T04:28:05.642Z","1.0.0":"2026-06-10T07:49:48.413Z","1.0.1":"2026-08-01T02:24:31.790Z","1.0.2":"2026-09-25T04:28:05.439Z"},"bugs":{"url":"https://github.com/AINative-Studio/ainative-memory-mcp/issues"},"author":{"url":"https://ainative.studio","name":"AINative Studio","email":"toby@rely.ventures"},"license":"MIT","homepage":"https://ainative.studio/agent-memory-api","keywords":["mcp","mcp-server","mcp-server-hosting","model-context-protocol","model-context-protocol-server","modelcontextprotocol","knowledge-graph","memory-server","persistent-memory","cloud-memory","server-memory-alternative","server-memory","memory","graph-memory","knowledge-base","entity-relations","semantic-search","vector-search","vector-database","embeddings","ainative","zerodb","zeromemory","ai-agents","agentic-ai","ai-tool-calling","agent-memory","claude","claude-code","claude-desktop","claude-ai-agents","windsurf","cursor","codex","n8n-ai","production-ready","composio-alternative","auto-provisioning","free-tier","cloud-persistence","cross-device","shared-memory","drop-in-replacement"],"repository":{"url":"git+https://github.com/AINative-Studio/ainative-memory-mcp.git","type":"git"},"description":"Enhanced MCP server-memory with ZeroDB cloud persistence and semantic vector search. Drop-in replacement for @modelcontextprotocol/server-memory that stores your knowledge graph in the cloud instead of local JSONL files.","maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"readme":"# ainative-memory-mcp\n\nEnhanced MCP knowledge graph memory server with cloud persistence and semantic search. Drop-in replacement for [`@modelcontextprotocol/server-memory`](https://github.com/modelcontextprotocol/servers/tree/main/src/memory).\n\n## Why this instead of server-memory?\n\n| Feature | server-memory | ainative-memory-mcp |\n|---------|--------------|-------------------|\n| Storage | Local JSONL file | ZeroDB cloud |\n| Persistence | Lost on machine wipe | Survives forever |\n| Cross-device | No | Yes (same API key = same graph) |\n| Semantic search | No (text match only) | Yes (vector similarity) |\n| Setup | Manual file path | Auto-provisions on first run |\n| Sharing | Copy files around | Share API key |\n\n## Quick Start\n\n### Claude Desktop / Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ainative-memory-mcp\"],\n      \"env\": {\n        \"ZERODB_API_KEY\": \"ak_your_key\"\n      }\n    }\n  }\n}\n```\n\nNo API key? Just omit it — a free ZeroDB instance is auto-provisioned on first run.\n\n### Cursor / Windsurf / VS Code\n\nSame config in your `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ainative-memory-mcp\"],\n      \"env\": {\n        \"ZERODB_API_KEY\": \"ak_your_key\"\n      }\n    }\n  }\n}\n```\n\n### Get an API Key\n\n```bash\nnpx zerodb-cli init\n```\n\nOr sign up at [ainative.studio](https://ainative.studio).\n\n## Tools (10)\n\nAll 9 original server-memory tools plus semantic search:\n\n### Original Tools\n\n| Tool | Description |\n|------|-------------|\n| `create_entities` | Create new entities with name, type, and observations |\n| `create_relations` | Create directed relations between entities |\n| `add_observations` | Add observations to existing entities |\n| `delete_entities` | Delete entities and their cascading relations |\n| `delete_observations` | Remove specific observations from entities |\n| `delete_relations` | Delete specific relations |\n| `read_graph` | Read the entire knowledge graph |\n| `search_nodes` | Search by text match (name, type, observations) |\n| `open_nodes` | Fetch specific entities by name with their relations |\n\n### New Tool\n\n| Tool | Description |\n|------|-------------|\n| `search_nodes_semantic` | Vector similarity search — find entities by meaning, not just exact text |\n\n#### Semantic Search Example\n\nThe original `search_nodes` only finds exact text matches. `search_nodes_semantic` understands meaning:\n\n```\nsearch_nodes(\"ML frameworks\")        -> might find nothing\nsearch_nodes_semantic(\"ML frameworks\") -> finds \"PyTorch\", \"TensorFlow\", \"JAX\"\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `ZERODB_API_KEY` | No* | ZeroDB API key (auto-provisions if missing) |\n| `ZERODB_PROJECT_ID` | No | ZeroDB project ID |\n| `ZERODB_API_URL` | No | API URL (default: `https://api.ainative.studio`) |\n\n*If no credentials are provided, a free instance is automatically provisioned on first run.\n\n## Auto-Provisioning\n\nOn first run without credentials:\n\n1. A free ZeroDB instance is provisioned automatically\n2. Credentials are saved to `.mcp.json` and `.env` in your project\n3. A claim URL is printed so you can take ownership of the instance\n4. Everything works immediately — no signup required\n\n## How It Works\n\nInstead of writing to a local `memory.jsonl` file, this server:\n\n1. **Entities** are stored as rows in a ZeroDB NoSQL table (`kg_entities`)\n2. **Relations** are stored in a separate table (`kg_relations`)\n3. **Vector embeddings** are automatically generated for each entity via ZeroMemory, enabling semantic search\n4. All data persists in the cloud and is accessible from any device with the same API key\n\n## Migration from server-memory\n\n1. Replace `@modelcontextprotocol/server-memory` with `ainative-memory-mcp` in your MCP config\n2. Add `ZERODB_API_KEY` to your env (or let it auto-provision)\n3. Re-create your entities (one-time migration — your old JSONL data stays on disk)\n\n## License\n\nMIT\n\n---\n\n## Powered by ZeroDB + AINative\n\nThis package is part of the [AINative](https://ainative.studio) ecosystem — the AI-native developer platform.\n\n### Why ZeroDB?\n\n| Feature | ZeroDB | Others |\n|---------|--------|--------|\n| Vector search | Built-in, free embeddings | Separate service (Pinecone, Qdrant) |\n| Agent memory | Cognitive memory with decay + reflection | DIY or Mem0 ($$$) |\n| File storage | S3-compatible, included | Separate S3 bucket |\n| NoSQL tables | Instant, schema-free | MongoDB Atlas, DynamoDB |\n| PostgreSQL | Managed, pgvector pre-installed | Neon, Supabase ($$$) |\n| Serverless functions | DB-event triggered | Firebase/Supabase Edge |\n| Pricing | Free tier, no credit card | Pay-per-query from day 1 |\n\n### Get Started Free\n\n```bash\nnpx zerodb-cli init    # Auto-configures your IDE\n```\n\nOr sign up at **[ainative.studio](https://ainative.studio)** — free tier, no credit card required.\n\n[View all ZeroDB packages →](https://docs.ainative.studio)\n\n---\n\n## Zero-Config Auto-Provisioning\n\n**No account needed to start.** On first run, this package automatically:\n\n1. Provisions a **free ZeroDB instance** (~800ms)\n2. Saves credentials locally (`.env`, `.mcp.json`)\n3. Prints a **claim link** in your terminal\n\n### The 72-Hour Window\n\nYour auto-provisioned instance is **free for 72 hours**. To keep your data permanently, visit the **claim URL** printed in your terminal.\n\n### For AI Agents\n\nIf a coding agent (Claude Code, Cursor, Windsurf) installs this package:\n- Auto-provisions without human intervention\n- The **claim URL** appears in agent output — visit it to take ownership\n- `.claude/CLAUDE.md` instructs agents to surface the claim link to you\n- Check `.env` or `~/.ainative/config.json` for your project ID if you miss it\n","readmeFilename":"README.md"}