ZeroDB MCP Server v2.0.8

Enterprise-grade Model Context Protocol (MCP) server providing full access to ZeroDB's vector search, quantum compression, NoSQL operations, and persistent memory for AI agents.

Key Features

• 60 Complete Operations - Full API coverage across all ZeroDB capabilities
• Vector Search - Semantic similarity search with 1536-dimensional embeddings
• Quantum Compression - Advanced vector compression using quantum algorithms
• NoSQL Tables - Flexible table operations for structured data
• File Storage - Secure file upload, download, and management
• Event System - Event-driven architecture with pub/sub support
• Project Management - Multi-tenant project isolation and management
• RLHF Integration - Reinforcement Learning from Human Feedback collection
• Admin Tools - System monitoring, optimization, and health checks
• Enterprise Security - JWT authentication with automatic token renewal
• 90%+ Test Coverage - Comprehensive test suite for production reliability

---

Table of Contents

• Installation
• Quick Start
• API Reference
  • Memory Operations (3)
  • Vector Operations (10)
  • Quantum Operations (6)
  • Table/NoSQL Operations (8)
  • File Operations (6)
  • Event Operations (5)
  • Project Operations (7)
  • RLHF Operations (10)
  • Admin Operations (5)
• Configuration
• Examples
• Migration Guide
• Troubleshooting
• Contributing
• License

---

Installation

NPM Global Installation

npm install -g ainative-zerodb-mcp-server

NPX (No Installation Required)

npx ainative-zerodb-mcp-server

Requirements

• Node.js >= 18.0.0
• NPM >= 9.0.0
• ZeroDB account with API credentials (see below)

---

Getting Started

Step 1: Create Your ZeroDB Account

Before using the MCP server, you need a ZeroDB account and project.

Option A: Register via Web (Recommended)

Visit: https://api.ainative.studio/docs

1. Click on "Register User" endpoint
2. Use the "Try it out" feature
3. Enter your email, password, and username

Option B: Register via API

curl -X POST 'https://api.ainative.studio/v1/public/auth/register' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "your-email@example.com",
    "password": "YourSecurePassword123!",
    "username": "yourname"
  }'

Response:

{
  "email": "your-email@example.com",
  "id": "user-uuid-here",
  "username": "yourname"
}

Step 2: Create a Project

After registration, create a project to get your PROJECT_ID:

# 1. Login to get your access token
curl -X POST 'https://api.ainative.studio/v1/public/auth/login-json' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "your-email@example.com",
    "password": "YourSecurePassword123!"
  }'

Response:

{
  "access_token": "eyJhbGc...",
  "token_type": "bearer",
  "expires_in": 1800
}

# 2. Create a project using your token
curl -X POST 'https://api.ainative.studio/v1/public/projects' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "My ZeroDB MCP Project",
    "description": "Project for Claude Desktop MCP integration"
  }'

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My ZeroDB MCP Project",
  "status": "ACTIVE",
  ...
}

Save this Project ID! You'll need it for the MCP configuration.

---

Quick Start

Step 3: Configure Claude Desktop

Add to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "zerodb": {
      "command": "npx",
      "args": ["ainative-zerodb-mcp-server"],
      "env": {
        "ZERODB_API_URL": "https://api.ainative.studio",
        "ZERODB_PROJECT_ID": "your-project-id-here",
        "ZERODB_USERNAME": "your-email@example.com",
        "ZERODB_PASSWORD": "your-password",
        "MCP_CONTEXT_WINDOW": "8192",
        "MCP_RETENTION_DAYS": "30"
      }
    }
  }
}

Step 4: Restart Claude Desktop

After saving the configuration, restart Claude Desktop to activate the MCP server.

Step 5: Test Your First Operation

In Claude Desktop, try:

Store a memory: "This is my first ZeroDB memory entry"

Claude will use the zerodb_store_memory tool to persist this information.

---

API Reference

All 60 operations are organized into 9 categories. Each operation is exposed as an MCP tool that Claude can invoke.

Memory Operations

1. zerodb_store_memory

Store agent memory in ZeroDB for persistent context across sessions.

Parameters:

• content (string, required) - Memory content to store
• role (string, required) - Message role: "user", "assistant", or "system"
• session_id (string, optional) - Session identifier (auto-generated if not provided)
• agent_id (string, optional) - Agent identifier (auto-generated if not provided)
• metadata (objec…