{
  "markdown": "# 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",
  "bytes": 5771,
  "sha": "45e9bd9e7ca5bae83e73a604d69230301363f68c80bb32cc81dc3f548798fa40",
  "repo_slug": "ainative-studio/ainative-memory-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ainative_studio_ainative_memor_07566f7d/readme"
}