ZeroDB MCP Server v2.5.2

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

See docs/changelog/CHANGELOG.md for the full, up-to-date version history.

Key Features

• 97 Complete Operations - Full API coverage across all ZeroDB capabilities including embedding tools
• Vector Search - Semantic similarity search with 384/768/1024/1536-dimensional embeddings
• Free Embeddings - Generate embeddings with BAAI BGE models (no OpenAI costs!)
• Quantum Compression - Advanced vector compression using quantum algorithms
• PostgreSQL Operations - Full SQL query execution, schema management, backups, and statistics
• 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 + SQL injection prevention
• 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)
  • PostgreSQL Operations (6)
• Configuration
• Examples
• Migration Guide
• Troubleshooting
• Contributing
• License
• Changelog

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

... [View full README on GitHub](https://github.com/ainative-studio/ainative-zerodb-mcp-server#readme)