io.github.AINative-Studio/ainative-memory-mcp

ainative-memory-mcp

Enhanced MCP knowledge graph memory server with cloud persistence and semantic search. Drop-in replacement for @modelcontextprotocol/server-memory.

Why this instead of server-memory?

Quick Start

Claude Desktop / Claude Code

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "ainative-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "ak_your_key"
      }
    }
  }
}

No API key? Just omit it — a free ZeroDB instance is auto-provisioned on first run.

Cursor / Windsurf / VS Code

Same config in your .mcp.json:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "ainative-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "ak_your_key"
      }
    }
  }
}

Get an API Key

npx zerodb-cli init

Or sign up at ainative.studio.

Tools (10)

All 9 original server-memory tools plus semantic search:

Original Tools

New Tool

Semantic Search Example

The original search_nodes only finds exact text matches. search_nodes_semantic understands meaning:

search_nodes("ML frameworks")        -> might find nothing
search_nodes_semantic("ML frameworks") -> finds "PyTorch", "TensorFlow", "JAX"

Environment Variables

*If no credentials are provided, a free instance is automatically provisioned on first run.

Auto-Provisioning

On first run without credentials:

1. A free ZeroDB instance is provisioned automatically
2. Credentials are saved to .mcp.json and .env in your project
3. A claim URL is printed so you can take ownership of the instance
4. Everything works immediately — no signup required

How It Works

Instead of writing to a local memory.jsonl file, this server:

1. Entities are stored as rows in a ZeroDB NoSQL table (kg_entities)
2. Relations are stored in a separate table (kg_relations)
3. Vector embeddings are automatically generated for each entity via ZeroMemory, enabling semantic search
4. All data persists in the cloud and is accessible from any device with the same API key

Migration from server-memory

1. Replace @modelcontextprotocol/server-memory with ainative-memory-mcp in your MCP config
2. Add ZERODB_API_KEY to your env (or let it auto-provision)
3. Re-create your entities (one-time migration — your old JSONL data stays on disk)

License

MIT

Powered by ZeroDB + AINative

This package is part of the AINative ecosystem — the AI-native developer platform.

Why ZeroDB?

Get Started Free

npx zerodb-cli init    # Auto-configures your IDE

Or sign up at ainative.studio — free tier, no credit card required.

View all ZeroDB packages →

Zero-Config Auto-Provisioning

No account needed to start. On first run, this package automatically:

1. Provisions a free ZeroDB instance (~800ms)
2. Saves credentials locally (.env, .mcp.json)
3. Prints a claim link in your terminal

The 72-Hour Window

Your auto-provisioned instance is free for 72 hours. To keep your data permanently, visit the claim URL printed in your terminal.

For AI Agents

If a coding agent (Claude Code, Cursor, Windsurf) installs this package:

• Auto-provisions without human intervention
• The claim URL appears in agent output — visit it to take ownership
• .claude/CLAUDE.md instructs agents to surface the claim link to you
• Check .env or ~/.ainative/config.json for your project ID if you miss it