Ainative Zerodb nasıl kurulur?

Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.

Ainative Zerodb için API anahtarı gerekiyor mu?

Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.

Ainative Zerodb hangi aktarımı kullanıyor?

Ainative Zerodb yerel olarak stdio üzerinden çalışır.

Ainative Zerodb MCP sunucusu | PlugMCP

Power your agent

Bu sunucuyu ekle

Yayıncının kendi komutu. PlugMCP uç noktası değildir.

Cursor'a ekle VS Code'a ekle PlugMCP’de çalıştır

Host a copy with our keys and logs.

Yerel komut

npx -y [email protected]

Claude Code'un yerel komutlar için kurulum bağlantısı yok. Aşağıdaki komutu kopyalayın ve bir terminalde çalıştırın.

shClaude Code

1claude mcp add ainative-zerodb-mcp-server -- npx -y ainative-zerodb-mcp-server@2.5.2

Bir terminalde çalıştırın.

jsonClaude Desktop

1{2  "mcpServers": {3    "ainative-zerodb-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Yerel · npmYayıncı kurulumuAdım adım: Claude içinde ekleme

Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark

PlugMCP’de çalıştır

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Başlat

Sunucu bilgileri

Yerel

Aktarım: stdio
Sürüm: 2.5.2
Son kontrol

Yayıncıdan

Dokümantasyon

ZeroDB MCP Server v2.3.2

npm install -g ainative-zerodb-mcp-server

npx ainative-zerodb-mcp-server

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

{
  "email": "[email protected]",
  "id": "user-uuid-here",
  "username": "yourname"
}

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

{
  "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"
  }'

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

{
  "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_API_KEY": "your-api-key",
        "MCP_CONTEXT_WINDOW": "8192",
        "MCP_RETENTION_DAYS": "30"
      }
    }
  }
}

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

{
  "memory_id": "uuid",
  "created_at": "2025-10-14T12:00:00Z"
}

{
  "content": "User prefers dark mode and TypeScript",
  "role": "system",
  "metadata": {
    "category": "preferences"
  }
}

{
  "memories": [
    {
      "memory_id": "uuid",
      "content": "string",
      "role": "user|assistant|system",
      "created_at": "timestamp",
      "similarity_score": 0.95
    }
  ]
}

{
  "query": "What were the user's preferences?",
  "limit": 5
}

{
  "session_id": "uuid",
  "agent_id": "uuid",
  "total_tokens": 1024,
  "memory_count": 15,
  "messages": [
    {
      "role": "user",
      "content": "string",
      "timestamp": "2025-10-14T12:00:00Z"
    }
  ]
}

{
  "session_id": "session-123",
  "max_tokens": 4096
}

{
  "vector_id": "uuid",
  "namespace": "windsurf"
}

{
  "vector_embedding": [0.1, 0.2, ..., 0.9], // 1536 values
  "document": "This is the source text",
  "metadata": {
    "source": "documentation",
    "page": 42
  }
}

{
  "success_count": 100,
  "failed_count": 0,
  "vector_ids": ["uuid1", "uuid2", ...]
}

{
  "vectors": [
    {
      "vector_embedding": [...],
      "document": "Document 1",
      "metadata": {"index": 1}
    },
    {
      "vector_embedding": [...],
      "document": "Document 2",
      "metadata": {"index": 2}
    }
  ],
  "namespace": "knowledge-base"
}

{
  "vectors": [
    {
      "vector_id": "uuid",
      "document": "string",
      "similarity_score": 0.95,
      "metadata": {}
    }
  ]
}

{
  "query_vector": [...], // 1536 values
  "namespace": "windsurf",
  "limit": 20,
  "threshold": 0.8
}

{
  "success": true,
  "deleted_id": "uuid"
}

{
  "vector_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "vector_id": "uuid",
  "vector_embedding": [...],
  "document": "string",
  "metadata": {},
  "created_at": "timestamp"
}

{
  "vector_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "vectors": [...],
  "total_count": 1000,
  "limit": 50,
  "offset": 0
}

{
  "namespace": "windsurf",
  "limit": 100,
  "offset": 200
}

{
  "total_vectors": 10000,
  "namespaces": {
    "windsurf": 5000,
    "default": 5000
  },
  "storage_bytes": 1048576,
  "avg_dimension": 1536
}

{
  "namespace": "windsurf"
}

{
  "index_id": "uuid",
  "namespace": "windsurf",
  "index_type": "hnsw",
  "status": "created"
}

{
  "namespace": "windsurf",
  "index_type": "hnsw",
  "params": {
    "m": 16,
    "ef_construction": 200
  }
}

{
  "optimized": true,
  "space_saved_bytes": 102400,
  "duration_ms": 1500
}

{
  "namespace": "windsurf"
}

{
  "export_id": "uuid",
  "download_url": "https://...",
  "expires_at": "timestamp"
}

{
  "namespace": "windsurf",
  "format": "json",
  "include_embeddings": true
}

{
  "compressed_vector": [...],
  "original_dimensions": 1536,
  "compressed_dimensions": 768,
  "compression_ratio": 0.5,
  "fidelity_score": 0.98
}

{
  "vector_embedding": [...],
  "compression_ratio": 0.6,
  "algorithm": "qaoa"
}

{
  "decompressed_vector": [...],
  "dimensions": 1536,
  "reconstruction_error": 0.02
}

{
  "compressed_vector": [...],
  "original_dimensions": 1536
}

{
  "vectors": [
    {
      "vector_id": "uuid",
      "document": "string",
      "similarity_score": 0.96,
      "quantum_score": 0.94,
      "hybrid_score": 0.95
    }
  ]
}

{
  "query_vector": [...],
  "namespace": "windsurf",
  "limit": 10,
  "quantum_weight": 0.7
}

{
  "optimized": true,
  "improvement_percentage": 35.5,
  "duration_ms": 5000
}

{
  "namespace": "windsurf",
  "optimization_target": "search_speed"
}

{
  "feature_map": [...],
  "quantum_circuit_depth": 10,
  "qubit_count": 12
}

{
  "vector_embedding": [...],
  "feature_map_type": "pauli"
}

{
  "kernel_similarity": 0.92,
  "quantum_advantage": 0.15,
  "computation_time_ms": 45
}

{
  "vector_a": [...],
  "vector_b": [...],
  "kernel_type": "rbf"
}

{
  "table_id": "uuid",
  "table_name": "string",
  "created_at": "timestamp"
}

{
  "table_name": "user_profiles",
  "schema": {
    "user_id": "uuid",
    "name": "string",
    "email": "string",
    "created_at": "timestamp"
  },
  "description": "User profile information"
}

{
  "tables": [
    {
      "table_id": "uuid",
      "table_name": "string",
      "row_count": 1000,
      "created_at": "timestamp"
    }
  ],
  "total_count": 10
}

{
  "limit": 100,
  "offset": 0
}

{
  "table_id": "uuid",
  "table_name": "string",
  "schema": {},
  "row_count": 1000,
  "created_at": "timestamp"
}

{
  "table_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "success": true,
  "deleted_id": "uuid",
  "rows_deleted": 1000
}

{
  "table_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "inserted_count": 100,
  "row_ids": ["uuid1", "uuid2", ...]
}

{
  "table_id": "123e4567-e89b-12d3-a456-426614174000",
  "rows": [
    {
      "user_id": "user-1",
      "name": "John Doe",
      "email": "[email protected]"
    },
    {
      "user_id": "user-2",
      "name": "Jane Smith",
      "email": "[email protected]"
    }
  ]
}

{
  "rows": [...],
  "total_count": 1000,
  "limit": 50,
  "offset": 0
}

{
  "table_id": "123e4567-e89b-12d3-a456-426614174000",
  "filters": {
    "email": {
      "$contains": "@example.com"
    }
  },
  "limit": 100
}

{
  "updated_count": 50,
  "row_ids": ["uuid1", "uuid2", ...]
}

{
  "table_id": "123e4567-e89b-12d3-a456-426614174000",
  "filters": {
    "user_id": "user-1"
  },
  "updates": {
    "email": "[email protected]"
  }
}

{
  "deleted_count": 25,
  "row_ids": ["uuid1", "uuid2", ...]
}

{
  "table_id": "123e4567-e89b-12d3-a456-426614174000",
  "filters": {
    "created_at": {
      "$lt": "2025-01-01"
    }
  }
}

{
  "file_id": "uuid",
  "file_name": "string",
  "size_bytes": 1024,
  "upload_url": "string"
}

{
  "file_name": "document.pdf",
  "file_data": "base64encodeddata...",
  "content_type": "application/pdf",
  "metadata": {
    "category": "documentation"
  }
}

{
  "file_id": "uuid",
  "file_name": "string",
  "file_data": "base64encodeddata...",
  "content_type": "string",
  "size_bytes": 1024
}

{
  "file_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "files": [
    {
      "file_id": "uuid",
      "file_name": "string",
      "size_bytes": 1024,
      "content_type": "string",
      "created_at": "timestamp"
    }
  ],
  "total_count": 100
}

{
  "limit": 100,
  "content_type": "application/pdf"
}

{
  "success": true,
  "deleted_id": "uuid"
}

{
  "file_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "file_id": "uuid",
  "file_name": "string",
  "size_bytes": 1024,
  "content_type": "string",
  "metadata": {},
  "created_at": "timestamp"
}

{
  "file_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "file_id": "uuid",
  "presigned_url": "https://...",
  "expires_at": "timestamp"
}

{
  "file_id": "123e4567-e89b-12d3-a456-426614174000",
  "expiry_seconds": 7200
}

{
  "event_id": "uuid",
  "event_type": "string",
  "created_at": "timestamp"
}

{
  "event_type": "user.signup",
  "event_data": {
    "user_id": "user-123",
    "email": "[email protected]"
  },
  "metadata": {
    "source": "web"
  }
}

{
  "events": [
    {
      "event_id": "uuid",
      "event_type": "string",
      "event_data": {},
      "created_at": "timestamp"
    }
  ],
  "total_count": 1000
}

{
  "event_type": "user.signup",
  "start_date": "2025-10-01T00:00:00Z",
  "limit": 100
}

{
  "event_id": "uuid",
  "event_type": "string",
  "event_data": {},
  "metadata": {},
  "created_at": "timestamp"
}

{
  "event_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "subscription_id": "uuid",
  "event_types": ["user.signup", "user.login"],
  "websocket_url": "wss://..."
}

{
  "event_types": ["user.signup", "user.login"],
  "filters": {
    "source": "web"
  }
}

{
  "total_events": 10000,
  "event_types": {
    "user.signup": 1000,
    "user.login": 9000
  },
  "timeline": [
    {
      "date": "2025-10-14",
      "count": 500
    }
  ]
}

{
  "start_date": "2025-10-01T00:00:00Z",
  "end_date": "2025-10-14T23:59:59Z",
  "group_by": "day"
}

{
  "project_id": "uuid",
  "project_name": "string",
  "created_at": "timestamp"
}

{
  "project_name": "My AI Application",
  "description": "Vector search for customer support",
  "settings": {
    "retention_days": 90
  }
}

{
  "project_id": "uuid",
  "project_name": "string",
  "description": "string",
  "settings": {},
  "created_at": "timestamp"
}

{
  "project_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "projects": [
    {
      "project_id": "uuid",
      "project_name": "string",
      "created_at": "timestamp"
    }
  ],
  "total_count": 10
}

{
  "limit": 100
}

{
  "project_id": "uuid",
  "updated_fields": ["project_name", "settings"],
  "updated_at": "timestamp"
}

{
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "settings": {
    "retention_days": 120
  }
}

{
  "success": true,
  "deleted_id": "uuid",
  "deleted_at": "timestamp"
}

{
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "confirm": true
}

{
  "project_id": "uuid",
  "vector_count": 10000,
  "memory_count": 5000,
  "table_count": 10,
  "file_count": 100,
  "storage_bytes": 10485760,
  "api_calls": 50000
}

{
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "start_date": "2025-10-01T00:00:00Z"
}

{
  "project_id": "uuid",
  "enabled_features": ["vectors", "tables"],
  "enabled_at": "timestamp"
}

{
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "features": ["vectors", "tables", "files"]
}

{
  "interaction_id": "uuid",
  "collected_at": "timestamp"
}

{
  "session_id": "session-123",
  "user_input": "How do I reset my password?",
  "agent_response": "You can reset your password by...",
  "feedback_score": 5,
  "metadata": {
    "model": "claude-3-sonnet",
    "response_time_ms": 1200
  }
}

{
  "feedback_id": "uuid",
  "collected_at": "timestamp"
}

{
  "agent_id": "agent-123",
  "session_id": "session-123",
  "feedback_type": "positive",
  "feedback_text": "Very helpful and accurate responses",
  "metrics": {
    "accuracy": 0.95,
    "helpfulness": 0.9
  }
}

{
  "workflow_feedback_id": "uuid",
  "collected_at": "timestamp"
}

{
  "workflow_id": "workflow-123",
  "session_id": "session-123",
  "completed": true,
  "duration_ms": 5000,
  "feedback": {
    "ease_of_use": 5,
    "effectiveness": 4
  }
}

{
  "error_report_id": "uuid",
  "collected_at": "timestamp"
}

{
  "session_id": "session-123",
  "error_type": "hallucination",
  "error_message": "Agent provided incorrect information about product pricing",
  "context": {
    "user_query": "What is the price?",
    "agent_response": "The price is $50"
  },
  "user_impact": "high"
}

{
  "total_interactions": 1000,
  "avg_feedback_score": 4.2,
  "positive_feedback": 850,
  "negative_feedback": 150,
  "collection_rate": 0.85
}

{
  "start_date": "2025-10-01T00:00:00Z",
  "end_date": "2025-10-14T23:59:59Z"
}

{
  "summary": [
    {
      "group_id": "agent-123",
      "interaction_count": 500,
      "avg_score": 4.5,
      "improvement_trend": 0.15
    }
  ]
}

{
  "group_by": "agent",
  "start_date": "2025-10-01T00:00:00Z"
}

{
  "session_id": "uuid",
  "collection_started": true,
  "started_at": "timestamp"
}

{
  "session_id": "session-123",
  "collection_config": {
    "collect_all_interactions": true,
    "require_explicit_feedback": false
  }
}

{
  "session_id": "uuid",
  "collection_stopped": true,
  "stopped_at": "timestamp",
  "total_collected": 50
}

{
  "session_id": "session-123"
}

{
  "session_id": "uuid",
  "interactions": [
    {
      "interaction_id": "uuid",
      "user_input": "string",
      "agent_response": "string",
      "feedback_score": 5,
      "timestamp": "timestamp"
    }
  ],
  "total_count": 50
}

{
  "session_id": "session-123",
  "limit": 200
}

{
  "broadcast_id": "uuid",
  "recipients": 10,
  "broadcasted_at": "timestamp"
}

{
  "event_type": "feedback.requested",
  "event_data": {
    "interaction_id": "interaction-123",
    "question": "Was this response helpful?"
  },
  "target_sessions": ["session-1", "session-2"]
}

{
  "total_projects": 100,
  "total_users": 500,
  "total_vectors": 1000000,
  "total_storage_bytes": 10737418240,
  "active_sessions": 50,
  "api_calls_24h": 100000,
  "avg_response_time_ms": 150
}

{
  "include_details": true
}

{
  "projects": [
    {
      "project_id": "uuid",
      "project_name": "string",
      "user_id": "uuid",
      "created_at": "timestamp",
      "storage_bytes": 1048576
    }
  ],
  "total_count": 100
}

{
  "limit": 500
}

{
  "user_id": "uuid",
  "project_count": 5,
  "vector_count": 10000,
  "storage_bytes": 10485760,
  "api_calls": 50000,
  "cost_estimate_usd": 25.50
}

{
  "user_id": "user-123",
  "start_date": "2025-10-01T00:00:00Z"
}

{
  "status": "healthy",
  "database": "connected",
  "storage": "healthy",
  "quantum_service": "operational",
  "cache": "healthy",
  "uptime_seconds": 86400,
  "last_check": "timestamp"
}

{}

{
  "optimized": true,
  "optimization_type": "all",
  "duration_ms": 30000,
  "space_freed_bytes": 1048576,
  "improvements": {
    "query_performance": 0.25,
    "storage_efficiency": 0.15
  }
}

{
  "optimization_type": "all"
}

{
  "query_id": "q_abc123",
  "query_type": "SELECT",
  "rows_returned": 10,
  "rows_affected": 0,
  "execution_time_ms": 45.2,
  "columns": ["id", "name", "email"],
  "rows": [{"id": 1, "name": "User", "email": "[email protected]"}],
  "success": true
}

{
  "sql": "SELECT * FROM users WHERE created_at > $1 LIMIT 10",
  "params": ["2025-01-01"],
  "read_only": true,
  "timeout_seconds": 30
}

{
  "schema": "public",
  "total_tables": 5,
  "database_size_mb": 150.5,
  "tables": [
    {
      "table_name": "users",
      "columns": [
        {"name": "id", "type": "INTEGER", "nullable": false, "primary_key": true},
        {"name": "email", "type": "VARCHAR(255)", "nullable": false, "unique": true}
      ],
      "indexes": [
        {"name": "users_pkey", "columns": ["id"], "unique": true},
        {"name": "users_email_idx", "columns": ["email"], "unique": true}
      ],
      "row_count": 1000,
      "size_mb": 25.5
    }
  ]
}

{
  "table_name": "users",
  "include_indexes": true,
  "include_constraints": true
}

{
  "table_name": "products",
  "created": true,
  "columns_count": 5,
  "indexes_created": 2,
  "indexes": [
    {"index_name": "products_sku_idx", "success": true},
    {"index_name": "products_name_idx", "success": true}
  ]
}

{
  "table_name": "products",
  "columns": [
    {"name": "id", "type": "SERIAL", "primary_key": true},
    {"name": "sku", "type": "VARCHAR(50)", "nullable": false, "unique": true},
    {"name": "name", "type": "VARCHAR(255)", "nullable": false},
    {"name": "price", "type": "DECIMAL(10,2)", "nullable": false},
    {"name": "created_at", "type": "TIMESTAMP", "default": "NOW()"}
  ],
  "indexes": [
    {"columns": ["sku"], "unique": true},
    {"columns": ["name"]}
  ]
}

{
  "backup_id": "backup_xyz789",
  "backup_type": "full",
  "status": "initiated",
  "estimated_size_mb": 250.0,
  "retention_days": 7,
  "created_at": "2025-12-07T18:00:00Z"
}

{
  "backup_type": "full",
  "retention_days": 30,
  "compression": true
}

{
  "restore_id": "restore_abc123",
  "backup_id": "backup_xyz789",
  "status": "in_progress",
  "estimated_time_minutes": 5,
  "started_at": "2025-12-07T18:05:00Z"
}

{
  "backup_id": "backup_xyz789",
  "restore_type": "full",
  "confirm_overwrite": true
}

{
  "project_id": "proj_123",
  "database_size_mb": 150.5,
  "table_count": 25,
  "active_connections": 5,
  "max_connections": 100,
  "queries_per_second": 120.5,
  "cache_hit_ratio": 0.95,
  "avg_query_time_ms": 15.2,
  "cpu_usage_percent": 25.0,
  "memory_usage_percent": 40.0,
  "replication_lag_ms": null
}

{
  "include_connections": true,
  "include_queries": true,
  "include_storage": true,
  "time_range": "day"
}

{
  "id": "ent_abc123",
  "canonical_name": "Alice Johnson",
  "entity_type": "person",
  "aliases": ["Alice"],
  "properties": { "role": "engineer" },
  "memory_count": 1,
  "status": "created"
}

{
  "source_name": "Alice Johnson",
  "target_name": "Acme Corp",
  "predicate": "works_at",
  "confidence": 0.9
}

{
  "entity": "Alice Johnson",
  "max_hops": 2
}

{
  "query": "pricing strategy",
  "limit": 5,
  "graph_weight": 0.5
}

Variable	Required	Default	Description
`ZERODB_API_URL`	No	`https://api.ainative.studio`	ZeroDB API base URL
`ZERODB_PROJECT_ID`	Yes	-	Your ZeroDB project ID
`ZERODB_API_KEY`	Recommended	-	Your ZeroDB API key (preferred auth method)
`ZERODB_USERNAME`	No*	-	DEPRECATED — Your ZeroDB account email. Switch to `ZERODB_API_KEY`. Will be removed in v3.0.
`ZERODB_PASSWORD`	No*	-	DEPRECATED — Your ZeroDB account password. Switch to `ZERODB_API_KEY`. Will be removed in v3.0.
`ZERODB_API_TOKEN`	No	-	Legacy alias for `ZERODB_API_KEY`
`MCP_CONTEXT_WINDOW`	No	`8192`	Maximum tokens in context window
`MCP_RETENTION_DAYS`	No	`30`	Memory retention period in days

// 1. Create a project for your knowledge base
const project = await zerodb_create_project({
  project_name: "Product Documentation KB",
  description: "Searchable product documentation"
});

// 2. Upload documentation files
const file = await zerodb_upload_file({
  file_name: "user_guide.pdf",
  file_data: "base64data...",
  content_type: "application/pdf"
});

// 3. Store vectors for semantic search
// (Assume you've generated embeddings from the documentation)
const vector = await zerodb_store_vector({
  vector_embedding: [...], // 1536-dimensional vector
  document: "How to reset your password: Navigate to Settings...",
  metadata: {
    source: "user_guide.pdf",
    page: 15
  }
});

// 4. Search the knowledge base
const results = await zerodb_search_vectors({
  query_vector: [...], // User query embedding
  limit: 5,
  threshold: 0.75
});

// 1. Store conversation in memory
await zerodb_store_memory({
  content: "User wants to book a flight to Paris",
  role: "user",
  session_id: "session-123"
});

await zerodb_store_memory({
  content: "I'll help you book a flight to Paris. What dates?",
  role: "assistant",
  session_id: "session-123"
});

// 2. Later in the conversation, get context
const context = await zerodb_get_context({
  session_id: "session-123",
  max_tokens: 4096
});

// Context includes all previous messages, token-optimized

// 1. Start RLHF collection for session
await zerodb_rlhf_start({
  session_id: "session-456",
  collection_config: {
    collect_all_interactions: true
  }
});

// 2. Collect interactions during conversation
await zerodb_rlhf_interaction({
  session_id: "session-456",
  user_input: "What's the weather like?",
  agent_response: "I don't have access to real-time weather data",
  feedback_score: 3,
  metadata: {
    model: "claude-3-sonnet",
    response_time_ms: 800
  }
});

// 3. Collect error reports
await zerodb_rlhf_error({
  session_id: "session-456",
  error_type: "capability_limitation",
  error_message: "Agent cannot access real-time data",
  user_impact: "medium"
});

// 4. Get RLHF summary
const summary = await zerodb_rlhf_summary({
  group_by: "session",
  start_date: "2025-10-14T00:00:00Z"
});

// 1. Store vectors with quantum compression
const compressed = await zerodb_quantum_compress({
  vector_embedding: [...], // Original 1536 dimensions
  compression_ratio: 0.5,
  algorithm: "qaoa"
});

// Store compressed version
await zerodb_store_vector({
  vector_embedding: compressed.compressed_vector,
  document: "Product description...",
  metadata: {
    compressed: true,
    original_dimensions: 1536
  }
});

// 2. Perform quantum hybrid search
const results = await zerodb_quantum_hybrid_search({
  query_vector: [...],
  quantum_weight: 0.7, // Higher weight for quantum similarity
  limit: 10
});

// Results include both classical and quantum similarity scores

// 1. Create a table for user profiles
const table = await zerodb_create_table({
  table_name: "user_profiles",
  schema: {
    user_id: "uuid",
    name: "string",
    email: "string",
    preferences: "json",
    created_at: "timestamp"
  }
});

// 2. Insert user data
await zerodb_insert_rows({
  table_id: table.table_id,
  rows: [
    {
      user_id: "user-1",
      name: "Alice Smith",
      email: "[email protected]",
      preferences: { theme: "dark", language: "en" }
    }
  ]
});

// 3. Query users
const users = await zerodb_query_rows({
  table_id: table.table_id,
  filters: {
    email: { $contains: "@example.com" }
  }
});

// 4. Update preferences
await zerodb_update_rows({
  table_id: table.table_id,
  filters: { user_id: "user-1" },
  updates: {
    preferences: { theme: "light", language: "en" }
  }
});

// All operations return structured responses with error handling
try {
  const result = await zerodb_store_vector({
    vector_embedding: [...],
    document: "Sample text"
  });

  if (result.isError) {
    console.error("Operation failed:", result.content[0].text);
    // Handle error appropriately
  } else {
    console.log("Success:", result.content[0].text);
  }
} catch (error) {
  // Handle unexpected errors
  console.error("Unexpected error:", error.message);
}

{
  "mcpServers": {
    "zerodb": {
      "command": "npx",
      "args": ["ainative-zerodb-mcp-server"],
      "env": {
        "ZERODB_API_URL": "https://api.ainative.studio",
        "ZERODB_PROJECT_ID": "your-project-id",
        "ZERODB_USERNAME": "[email protected]",
        "ZERODB_PASSWORD": "YourPassword123!"
      }
    }
  }
}

{
  "mcpServers": {
    "zerodb": {
      "command": "npx",
      "args": ["ainative-zerodb-mcp-server"],
      "env": {
        "ZERODB_API_URL": "https://api.ainative.studio",
        "ZERODB_PROJECT_ID": "your-project-id",
        "ZERODB_API_KEY": "zdb_your-api-key-here"
      }
    }
  }
}

API Endpoint Consolidation
- v1.x: Direct API calls to various endpoints
- v2.0: All operations go through unified MCP execute endpoint
Impact: No code changes needed if using MCP tools

Tool Naming Convention

v1.x: Some tools lacked zerodb_ prefix
v2.0: All tools prefixed with zerodb_

Migration:

// Old (v1.x)
store_memory(...) → zerodb_store_memory(...)
search_memory(...) → zerodb_search_memory(...)

// New (v2.0)
zerodb_store_memory(...) // Consistent prefix

Parameter Changes

Memory operations: memory_metadata → metadata
Vector operations: vector_metadata → metadata

Migration:

// Old (v1.x)
{
  content: "...",
  memory_metadata: { key: "value" }
}

// New (v2.0)
{
  content: "...",
  metadata: { key: "value" }
}

New Required Environment Variables
- ZERODB_PROJECT_ID is now required (was optional in v1.x)
Migration: Add to your config:
```
{
  "env": {
    "ZERODB_PROJECT_ID": "your-project-id"
  }
}
```

Update Package

npm update ainative-zerodb-mcp-server
# or
npm install -g [email protected]

Update Configuration
- Add ZERODB_PROJECT_ID to environment variables
- Update any custom tool names to include zerodb_ prefix
Test Existing Functionality
- All v1.x operations remain compatible
- Test memory and vector operations still work
Gradually Adopt New Features
- Start with new features that provide immediate value
- Refer to API Reference for new operation documentation

# The MCP server logs to stderr
# In Claude Desktop, check: ~/Library/Logs/Claude/mcp*.log

# Clone repository
git clone https://github.com/AINative-Studio/ainative-zerodb-mcp-server.git
cd ainative-zerodb-mcp-server

# Install dependencies
npm install

# Run tests
npm test

# Lint code
npm run lint

# Run security audit
npm run security:audit

# Run tests with coverage
npm test

# Watch mode for development
npm run test:watch

# CI mode
npm run test:ci

Ainative Zerodb

Q: Ainative Zerodb en son ne zaman kontrol edildi?

Son kontrol: 2026-11-15. AINative ZeroDB MCP Server - 93 operations for vector search, TurboQuant vector compression (PolarQuant + QJL), NoSQL, dedicated PostgreSQL management, files, events, RLHF, knowledge graph (entities, edges, traversal, GraphRAG, ontology CRUD, contradictio

ainative-studioBu sunucuyu sahiplen

AINative ZeroDB MCP Server - 93 operations for vector search, TurboQuant vector compression (PolarQuant + QJL), NoSQL, dedicated PostgreSQL management, files, events, RLHF, knowledge graph (entities,

Databases Knowledge Memory

Cursor'a ekle VS Code'a ekle PlugMCP’de çalıştırBu sunucuyu sahiplen

Cursor'a ekle VS Code'a ekle PlugMCP’de çalıştır

1{2  "mcpServers": {3    "ainative-zerodb-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP sunucusu

Aktarım: stdio
Durum: Yerel

Bu sunucuyu ekle

Host a copy with our keys and logs.

Sunucu bilgileri

Dokümantasyon

ZeroDB MCP Server v2.3.2

What's New in v2.3.2

Key Features

Table of Contents

Installation

NPM Global Installation

NPX (No Installation Required)

Requirements

Getting Started

Step 1: Create Your ZeroDB Account

Option A: Register via Web (Recommended)

Option B: Register via API

Step 2: Create a Project

Quick Start

Step 3: Configure Claude Desktop

Step 4: Restart Claude Desktop

Step 5: Test Your First Operation

API Reference

Memory Operations

1. zerodb_store_memory

2. zerodb_search_memory

3. zerodb_get_context

Vector Operations

4. zerodb_store_vector

5. zerodb_batch_upsert_vectors

6. zerodb_search_vectors

7. zerodb_delete_vector

8. zerodb_get_vector

9. zerodb_list_vectors

10. zerodb_vector_stats

11. zerodb_create_vector_index

12. zerodb_optimize_vectors

13. zerodb_export_vectors

Quantum Operations

14. zerodb_quantum_compress

15. zerodb_quantum_decompress

16. zerodb_quantum_hybrid_search

17. zerodb_quantum_optimize

18. zerodb_quantum_feature_map

19. zerodb_quantum_kernel

Table/NoSQL Operations

20. zerodb_create_table

21. zerodb_list_tables

22. zerodb_get_table

23. zerodb_delete_table

24. zerodb_insert_rows

25. zerodb_query_rows

26. zerodb_update_rows

27. zerodb_delete_rows

File Operations

28. zerodb_upload_file

29. zerodb_download_file

30. zerodb_list_files

31. zerodb_delete_file

32. zerodb_get_file_metadata

33. zerodb_generate_presigned_url

Event Operations

34. zerodb_create_event

35. zerodb_list_events

36. zerodb_get_event

37. zerodb_subscribe_events

38. zerodb_event_stats

Project Operations

39. zerodb_create_project

40. zerodb_get_project

41. zerodb_list_projects

42. zerodb_update_project

43. zerodb_delete_project

44. zerodb_get_project_stats

45. zerodb_enable_database

RLHF Operations

46. zerodb_rlhf_interaction

47. zerodb_rlhf_agent_feedback

48. zerodb_rlhf_workflow

49. zerodb_rlhf_error

50. zerodb_rlhf_status

1. `zerodb_store_memory`

2. `zerodb_search_memory`

3. `zerodb_get_context`

4. `zerodb_store_vector`

5. `zerodb_batch_upsert_vectors`

6. `zerodb_search_vectors`

7. `zerodb_delete_vector`

8. `zerodb_get_vector`

9. `zerodb_list_vectors`

10. `zerodb_vector_stats`

11. `zerodb_create_vector_index`

12. `zerodb_optimize_vectors`

13. `zerodb_export_vectors`

14. `zerodb_quantum_compress`

15. `zerodb_quantum_decompress`

16. `zerodb_quantum_hybrid_search`

17. `zerodb_quantum_optimize`

18. `zerodb_quantum_feature_map`

19. `zerodb_quantum_kernel`

20. `zerodb_create_table`

21. `zerodb_list_tables`

22. `zerodb_get_table`

23. `zerodb_delete_table`

24. `zerodb_insert_rows`

25. `zerodb_query_rows`

26. `zerodb_update_rows`

27. `zerodb_delete_rows`

28. `zerodb_upload_file`

29. `zerodb_download_file`

30. `zerodb_list_files`

31. `zerodb_delete_file`

32. `zerodb_get_file_metadata`

33. `zerodb_generate_presigned_url`

34. `zerodb_create_event`

35. `zerodb_list_events`

36. `zerodb_get_event`

37. `zerodb_subscribe_events`

38. `zerodb_event_stats`

39. `zerodb_create_project`

40. `zerodb_get_project`

41. `zerodb_list_projects`

42. `zerodb_update_project`

43. `zerodb_delete_project`

44. `zerodb_get_project_stats`

45. `zerodb_enable_database`

46. `zerodb_rlhf_interaction`

47. `zerodb_rlhf_agent_feedback`

48. `zerodb_rlhf_workflow`

49. `zerodb_rlhf_error`

50. `zerodb_rlhf_status`

51. `zerodb_rlhf_summary`

52. `zerodb_rlhf_start`

53. `zerodb_rlhf_stop`

54. `zerodb_rlhf_session`

55. `zerodb_rlhf_broadcast`

56. `zerodb_admin_system_stats`

57. `zerodb_admin_list_projects`

58. `zerodb_admin_user_usage`

59. `zerodb_admin_health`

60. `zerodb_admin_optimize`

61. `zerodb_postgres_query`

62. `zerodb_postgres_schema_info`

63. `zerodb_postgres_create_table`

64. `zerodb_postgres_backup`

65. `zerodb_postgres_restore`

66. `zerodb_postgres_stats`

`zerodb_graph_upsert_entity`

`zerodb_graph_create_edge`

`zerodb_graph_traverse`

`zerodb_graph_rag_search`

`zerodb_graph_list_entities`

`zerodb_graph_neighbors`

`zerodb_graph_stats`

`zerodb_graph_merge_entities`

`zerodb_graph_ontology_get`

`zerodb_graph_ontology_upsert`

`zerodb_graph_ontology_infer`

`zerodb_graph_ontology_suggestions`

`zerodb_graph_contradictions_list`

`zerodb_graph_contradictions_resolve`